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Foreword 

This Technical Specification (TS) has been produced by the 3'^'^ Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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1 Scope 

The present document covers the minimum characteristics considered necessary in order to provide compliance to 
GSM 03.19 "SIM API for Java Card ™" [7]. 

The present document describes the technical characteristics and methods of test for testing the SIM API for Java Card 
(TM) [7] implemented in the subscriber identity modules (SIMs) for GSM. It specifies the following parts: 

- test applicabiUty 

- test envirormient description 

- tests format 

- test area reference 
conformance requirements 

- test auite files 

- test procedure 

- test coverage and, 

- a description of the associated testing tools that shall be used. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 



[1] (void) 
[2] (void) 

[3] GSM 11.11: "Digital cellular telecommunication system (Phase 2+); Specification of the 

Subscriber Identity Module - Mobile Equipment (SIM - ME) interface". 

[4] GSM 11.14: "Digital cellular telecommunications system (Phase 2+); 

Specification of the SIM application toolkit for the Subscriber Identity Module - Mobile 
Equipment (SIM - ME) interface". 

[5] GSM 11.17: "Subscriber Identity Module" (SIM) conformance test specification". 

[6] (void) 

[7] GSM 03.19 Rel-98: "Digital cellular telecommunications system (Phase 2+)\ Subscriber Identity 

Module AppUcation Programming Interface (SIM API); SIM API for Java Card™; Stage 2". 

[8] GSM 03.48 Rel-99: "Digital cellular telecommunications system (Phase 2+)\ Security Mechanisms 

for the SIM appUcation toolkit; Stage 2" 

[9] ISO/IEC 7816-3 (1997) " Identification cards - Integrated circuit(s) cards with contacts. Part 3: 

Electronic signals and transmission protocols". 
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[10] GSM 02.19 "Digital cellular telecommunications system (Phase 2+, Release 98); Subscriber 

Identity Module Application Programming Interface (SIM API); Service description; Stage 1". 

[11] SUN Java Card Specification "Java Card 2.1 API Specification". 

[12] SUN Java Card Specification "Java Card 2.1 Runtime Environment Specification". 

[13] SUN Java Card Specification "Java Card 2.1 VM Architecture Specification". 

[14] ETSI TS 101 220 v3.0.0 "Numbering System for Telecommunication IC card applications". 

[15] GSM 11.10-1: "Digital cellular teleconmiunication system (Phase 2+); Mobile Station (MS) 

conformance specification; Part 1: Conformance specification". 

3 Definitions and abbreviations 
3.1 Definitions 



The definitions specified in GSM 11.10-1 [15] clause 3.3 shall apply, unless otherwise specified in the present clause. 

Applet: An Applet is an application built up using a number of classes which will run under the control of the Java 
Card virtual machine. 

Applet installation parameters: Default values for applet installation parameters. 

Applet loading script: File containing the APDU commands that will load and install the test applet in the card. 

CleanUp Script file: File containing the APDU commands that will restore the Default Initial Conditions on the SIM 

Conformance Requirement Reference: Description of the expected card behaviour according to 03.19 specification. 

Expected state: the state in which the SIM is supposed to be after the execution of the test procedure appUed on the 
relevant initial conditions 

Security parameters: Minimum security requirements defined for the applet installation process. 

Test Area: Set of Test Cases applicable to a specific part ( class method, framework behaviour, . . . ) of the 03 . 19 

specification. 

Test Case: Elementary test that checks for compUance with one or more Conformance Requirement References. 
Test Output file: TBD. 

Test procedure: the sequence of actions/commands to perform all the test cases defined in a test area. 
Test Script file: File containing the APDU commands that will execute and verify the test results. 
Test Toolkit Applet: Applet designed to test a specific functionality of the SIM API 03.19 specification. 

3.2 Abbreviations 

For the purpose of the present document, the following abbreviations apply, in addition to those listed in 
GSM 01.04 [2]: 

AC Application Code 

AID Application Identifier 

APDU Application Protocol Data Unit 

API Application Programming Interface 

CAD Card Acceptance Device 

FFS For Further Study 

IFD Interface Device 

JCRE Java Card^^ Run Time Environment 
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JVM Java Virtual Machine 

SIM Subscriber Identity Module 

SE Sending Entity 



4 



Test Environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 



4.1 



Applicability 



The tests defined in this specification shall be performed taking into account the services supported by the card as 
specified in the EFsst file. 

This specification contains tests that test interoperability at the API level. This specification does not currently contain 
tests for interoperability at the SIM API framework and at the byte code level. These are for further study. 

The test defined in this specification are applicable to cards implementing TS 03.19 [7] version 7.4.0 unless otherwise 
stated. 



4.2 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 
, Elements of the Test Suite 



GSM03.19and 
Java Card™ 2.1 
export files 



Applet loading 
script 



Test 
Toolkit 
Applet 




Note: This diagram shows the test architecture required to test interoperability at both API and bytcode level. 
The latter is currently not included in the current specification. The diagram is for information. 
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4.3 Tests format 
4.3.1 Test Area Reference 

Each test area is referenced as follows: 

API Testing:: 'API_[package name]_[classname]_[methodiiame]' where 
package name: 

sim.access package: '1' 

sim.toolkit package: '2' 
class name: 

yyy: 3 letters for each class. 

See Annex A for full classes acronyms hst. 
method name: 

zzzz [input parameters]: 

See Annex A for full methods name acronyms list. 
FWK: framework testing 
Chapter name: 

XXX : 3 letters for each chapter 
See annex F for full chapter acronyms list 
Subchapter name 

yyyy: : 4 letters for each subchapter 
See annex F for full subchapter acronyms list 
LDR: loader testing 
[TBD] 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 
Method prototype as hsted in GSM 03.19 [7]specification. 

- Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN) 

- Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP) 

- Context error: 

- Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC) 
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4.3.1.2 Test Area files 

The files included in the Test Area use the following naming convention: 

- Test Script: [Test Area Reference]_[Test script number]. scr 

- Test Applet: [Test Area Reference]_[Test applet number] Java 
Load Script: [Test Area Reference]_[Load Script number]. Idr 

- Cleanup Script: [Test Area Reference]_[Cleanup Script number] .clr 

- Parameter File: [Test Area Reference]_[Parameter File number] .par 

The test script, applet, installation parameters, load script, cleanup script and conversion parameters numbers start from 
'1'. 

The test script, load script and cleanup script shall share a conamon syntax and format (see Annex B). 

The parameter file has an own syntax (see Annex G) and contains parameters to be used for CAP-file conversion and 

loading/cleanup script generation. 

Scripts file shall be run in the following order: 
[Test Area Reference]_l.ldr 
[Test Area Reference]_l.scr 
[Test Area Reference]_l.clr 
[Test Area Reference]_2.1dr 
[Test Area Reference]_2.scr 
[Test Area Reference]_2.clr 



[Test Area Reference]_n.ldr 
[Test Area Reference]_n.scr 
[Test Area Reference]_n.clr 
In case that one of the files is not needed, it shall be skipped during the tests execution. 

4.3.1.3 Test Procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API Expectation 


APDU Expectation 




Test Case detailed description 


API expected behiavior. 


Expected response at APDU 
level. 



4.3.1 .4 Test Coverage 

The table at the end of each test procedure indicates the correspondence between the Conformance Requirements 
Reference (CRR) and the different test cases. 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



15 



ETSI TS 101 955 V7.4.1 (2002-03) 



4.4 Initial Conditions 

The Initial Conditions are a set of general prerequisites for the SIM prior to the execution of testing. For each test 
procedure described in this document, the following rules apply to the Initial Conditions: 

- unless otherwise stated, the file system and the files' content shall fulfil the requirements described in the 
"Default Prepersonalisation" paragraph; 

unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages specific 
to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 

4.5 Package name 

Java packages integrating this Test Suite shall follow this naming convention: 

sim.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
sim.access package. 

sim.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 

framework. 

sim.test.util: for the Test util package defined in this Test Suite. 

sim.test.toolkit.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19[7] 
sim.toolkit package. 

Example: The package ../sim.test.access. [Test Area Reference] creates the following directory structure 

../sim/test/access/[Test Area Reference]/API_l_.. ._[!.. n].*, where API_l_..._[l..n].*' are the 
different test applets Java source files used in [Test Area Reference]. 

4.6 AID Coding 

The AID coding for the Test Packages, Applet classes and Applet shall be as specified in TS 101 220 [14]. In addition, 
the following TAR values are defined for use within the present document: 



TAR Coding (3 bytes/ 24 bits): 



bl 


hi 


b3 


b4 


b5 


b6 : :b21 


b22 


b23 


b24 





























Specific Test Applet Name 



Test Package Identifier 



Test package Identifier( bits bl-b3): 

000 reserved (as TAR= '00.00.00' is reserved for Card Manager) 

001 API 

010 Framework 

011 Loader 

111 sim.test.util 
other values are RFU 
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Application Provider specific data (1 byte): 
'00' for Package 
'Or for Applet class 
'02' for Applet Instance 

For example, the AID of Package sim.test.util is 'AO 00 00 00 09 00 02 FF FF FF FF 89 EO 00 00 00' 

4.6.1 Specific Test Applet Name for API 



Specific applet test name (bits b4-b24): 



M 


b5 


b6 


b7 


b8 


b9 


blO 


bll 


bl2 


bl3 


bl4 


bl5 


bl6 


bl7 


bl8 


bl9 


b20 


b21 


b22 


b23 


b24 



Applet instance 
Number 

Applet Class Number 

Method 

I I I I I Class 

API Test Package 

for API Test Package(3 bits) 
001 sim.access 
010 sim. toolkit 
other are RFU 

Class (5 bits): need to be assigned specification order see Annex A for the full Ust 
Method (6 bits): need to be assigned specification order see Aimex A for the full list 

Applet Class Number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance Number (2 bits) defined in the test procedure it shall start with 01 for applet instance and shall 
be 00 for package and class. 

4.6.2 Specific Test Applet Name for Framework 



Specific applet test name (bits b4-b24): 



b4 


b5 


b6 


b7 


b8 


b9 


blO 


bll 


bl2 


bl3 


bI4 


bl5 


bl6 


bl7 


bl8 


bl9 


b20 


b21 


b22 


b23 


b24 



I |_RFU ( set to ) 

Applet instance 
Number 

Applet Class Number 
Test Area within the 
chapter 

Chapter 

for Chapter (5 bits) 

00001 Toolkit Installation Parameters 

00010 Minimum Handler AvailabiUty 

00011 Handler Integrity 
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00100 Applet Triggering 

00101 Proactive Command Sending 

00110 Framework Security 

00111 Envelope Response Posting 

01000 File System Context 

01001 Exception Handling 

01010 Other parts transferred to framework from API 
other are RFU 

Test Area within the chapter (6 bits): values are defined in Aimex F 

Applet Class number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance number (3 bits) defined in the test procedure it shall start with 01 for applet instance and shall be 
00 for package and class. 



These subclauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 



This test tool shall meet the following requirements: 

- be able to send command to the card TPDU; 

- be able to check none, only a part, or all of the data returned; 

- be able to check none, only part, or all of the status returned; 
be able to accept all valid status codes returned; 

be able to support Reader commands; 

- be able to generate a log file for each test execution. 

- if more data is returned than defined in the test specification, the tool shall continue; 

- if less data is returned than defined in the test specification, the tool shall aborts and return an error; 

- if there is an error in data or status returned, the tool shall abort and return an error. 
The log file produced by the test tool shall include the following information: 

all commands issued; 
all data returned; 

- all status returned; 

- all errors codes; 

- expected data and status in case of error; 

- comments from the scripts; 

- a log message to report success or failure of the test. 



4.7 



Test Equipment 



4.7.1 



APDU tool 
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4.7.2 Util package 

Annex D includes Java source code for the sim.test.util package as well as loading , testing and cleaning script 
examples. 

4.7.3 Applet installation parameters 
4.7.3.1 Security parameters 

Loading scripts shall use the following security parameters as stated in GSM 03.48 [8] for applet installation: 



Parameter 


Value in hexadecimal 


SPl 


OA 00 


KIC 


00 


KID 


11 


TAR 


00 00 00 


CNTR 


00 00 00 00 01 


PCNTR 


00 


Key 


01 23 45 67 89 AB CD EF 



4.7.3.2 Loading components 

Cap files in loading scripts shall not include the descriptor component as described in Java Card 2.1 VM Architecture 
Specification [13]. 

4.8 Testing methodology 
4.8.1 Test interfaces and facilities 

The SIM-ME interface provides the main transport interface for the purpose of performing conformance tests. 
The SIM API interface provides the main test interface for the purpose of performing conformance tests. 



5 Test plan 

The test plan is divided according to the SIM API specification, that way the tests will follow the class hierarchy for the 
sim.toolkit and sim.access package; for the SIM Toolkit framework this test plan describes the different points that will 
be tested with the present test specification. 



6 API Test Plan 

6.1 Package sim.access: 
6.1.1 Interface SIMView 

Note: The Test applet shall be run on a class that implements this interface. 

6.1.1.1 Constants 

Test Area Reference: API_l_SVW_CONST 
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6.1.1.1.1 Conformance Requirements 

This section does not describe the conformance requirements for a method, but rather for the constants of the interface. 
Normal execution 

CRRNl: The constants shall have the same name and value that is defined in GSM 03.19 [7]. 

6.1.1.1.2 Test Suite Files 

None. 

6.1.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.1 .1 .2 Method select(short fid, byte[] fci, short fciOffset, short fciLength) 

Test Area Reference: API_1_SVW_ SLCTS_BSS 
6.1.1.2.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short select (short fid, 
byte [ ] fci, 
short fciOffset, 
short fciLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
S IMViewExcept ion 

Normal execution 

CRRNl: If the desired file is selected, the length of the FCI (File Control Information) which has been written to the 
array fci is returned. 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN4: After selecting a DF/MF no EF is selected. 

CRRN5: After selecting a linear fixed EF no record is selected. 

CRRN6: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN7: The current files (file context) of any other applets shall not be changed. See GSM 03.19 [7] - §5.2. This 
will be tested during the testing of the framework. 

CRRN8: The information returned by fci shall be formatted as described in GSM 11.11 [3], §9.2.1. 

CRRN9: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected. 
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5) The MF can always be selected. 
Parameter errors 

CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci.Iength, or fciOffset equals fci.Iength, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules Usted in 
CRRN9, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.2.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 


API. 


.1. 


.SVW. 


.SECTS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.1. 


.SVW. 


.SECTS. 


.BSS. 


.l.java 


Load Script: 


API. 


.1. 


.SVW. 


.SECTS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


.SVW. 


.SECTS. 


.BSS. 


.l.ch- 
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6.1.1.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Select EFICCID In MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
byte [ ] fci = new byte [34] 
fciOffset = 
fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return a value not greater 
than 20. 

<Description of fci: 

XX XX 

XX XX 

2F E2 

04 

> 




2 


Select EFicciD in IVIF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
fciOffset = 
fciLength = 13 
select ( ) 


No exception shall be thrown. 
Shall return 13. 

fci shall contain the first 13 bytes of 
the FCI structure. 




3 


Select DFgsm in MF 

fid = SIMView.FID DF GSM 

fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the first 7 bytes 

of the FCI. 

< Description of fci: 

XX XX 
XX XX 
IF 20 
02 
> 




3 


Select DFgsm in MF 

fid = SIMView.FID_DF_GSM 

fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 
structure. 

<Description of fci: 

XX XX 
XX XX 
IF 20 
02 
> 




4 


Select EFacm In DFgsm (CycllcEF) 

fid = SIMView.FID_EF_ACM 

fciOffset = 
fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return a value between 15 
and 20. (Cyclic EF) 
fci shall contain the first 15 or more 
bytes of the FCI structure. 
fci[14] shall have the value 3 
(length of record). 




5 


Select MF 

fid = SIMView.FID_MF 

rciuttset — u 
fciLength = 34 
select ( ) 


No exception shall be thrown. 
Shall return a value between 22 
and 34. 

fci shall contain the entire FCI 
structure. 




6 


Select DFtelecom in MF 

fid = SIMView.FID_DF_TELECOM 
fci[0] = fci[l] = '05' 

f ni Of f spt = 9 

fciLength = 20 
select 


No exception shall be thrown. 
Shall return 20. 

fci shall contain the first 20 bytes of 

the FCI structure starting at index 
2. The first two bytes shall (still) 
have the value '05'. 




7 


Select EFfdn in DFtelecom (Linear FixedEF) 

fid = SIMView.FID_EF_FDN 

fciOffset = 
fciLength = 15 
select ( ) 


No exception shall be thrown. 
Shall return 15. 

fci shall contain the first 1 5 bytes of 
the FCI structure. 
fci[14] shall have the value 28 
(length of record). 




8 


fci is null 

fid = SIMView.FID_EF_FDN 
byte[l nullBuffer = null 
fciOffset = 
fciLength = 15 
select ( ) 


Shall throw 

java.lang.NullPointerException. 
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Id 



Description 



API Expectation 



APDU Expectation 



fciOffset < 

fid = SIMView.FID_EF_FDN 

fciOffset = -1 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



10 



fciLength < 

fid = SIMView.FID_EF_FDN 

fciOffset = 
fciLength = -1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



11 



fciOffset + fciLength > fci.length 

fid = SIMView.FID_EF_FDN 
fciOffset = 20 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



12 



fciOffset >= fci.length 

fid = SIMView.FID_EF_FDN 

fciOffset = 34 
fciLength = 1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception 



13 



1 - fid = 
fciOffset 
fciLength 
select ( ) 

2 - fid = 
select ( ) 

3 - fid = 
select ( ) 

4 - fid = 
select ( ) 

5 - fid = 
select ( ) 

6 - fid = 
select ( ) 

7 - fid = 
select 

8 - fid = 
select 

9 - fid = 
select ( ) 



Selection possibilities 

SIMView.FID_MF 

= 
= 15 

SIMView.FID_DF_TELECOM 

SIMView.FID_DF_GRAPHICS 

SIMView.FID_DF_TELECOM 

SIMView.FID_DF_GRAPHICS 

SIMView.FID_MF 

SIMView.FID_DF_GSM 

SIMView.FID_DF_TELECOM 

SIMView.FID_DF_TELECOM 



1 - No exception 

2 - No exception 

3 - No exception 

4 - No exception 

5 - No exception 

6 - No exception 

7 - No exception 

8 - No exception 

9 - No exception 



shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 



thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown. 
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EF not selected after lUIF/DF selection 

1 - fid = SIMView.FID_MF 

select 

fid = SIMView.FID_EF_ICCID 

select ( ) 

2 - fid = SIMView.FID_MF 

select 
readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 



15 



No selection of non-reachable file 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid = SIMView.FID_EF_ACM 

select ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code FILE NOT FOUND. 



16 



No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 
select ( ) 

3 - fid = FID_EF_LARU 

select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD_NUMBER_NOT_AVAIL 
ABLE. 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



23 



ETSI TS 101 955 V7.4.1 (2002-03) 



Id 


Description 


API Expectation 


APDU Expectation 


17 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 

select ( ) 

3 - fid = FID_EF_CARU 

select ( ) 

4 - byte [] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal ) 

5 - fid = FID_EF_CARU 
select 

readRecord (data2 ) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 





6.1.1.2.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-7 


N2 


3,5 


N3 


1,2, 4, 6,7 


N4 


14 


N5 


16 


N6 


17 


N8 


1,3 


N9 


1-7, 13 


P1 


8 


P2 


9 


P3 


10 


P4 


11, 12 


C1 


15 


C2, C3 


Not Tested 



6.1.1.3 Method select (short fid) 

Test Area Reference: API_1_SVW_SLCTS 

6.1.1.3.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public void select (short fid) 

throws SIMViewException 

Normal execution 

CRRNl: If the desired tile is selected, no exception is thrown. 
CRRN2: After selecting a DF/MF no EF is selected. 

CRRN3: After selecting a linear fixed EF no record is selected. 

CRRN4: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN5: The current files (file context) of any other applets shall not be changed [03.19 - §5.2]. This will be tested 
during the testing of the framework. 

CRRN6: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibhng DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected. 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



24 



ETSI TS 101 955 V7.4.1 (2002-03) 



5) The MF can always be selected. 

Parameter errors 

No requirements. 

Context errors 

CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CCRN6, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 



6.1.1.3.2 



Test Suite Files 



Additional requirements for the GSM personalisation: None 



Test Script: 



API_1_SVW_SLCTS_1 .scr 



Test Applet: 



API_1_SVW_SLCTS_1 .Java 



Load Script: 



API_1_SVW_SLCTS_1 .Idr 



Cleanup Script: 



API_1_SVW_SLCTS_1 .ch 
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6.1.1.3.3 



Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



SIM Initialisation 



Responses ignored. 



Select EFicciD in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 

select ( ) 



No exception shall be thrown. 



EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 

select ( ) 

fid = SIMView.FID_EF_ICCID 

select ( ) 

2 - fid = SIMView.FID_MF 
select ( ) 

readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 



No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 

select 

2 - fid = FID_DF_SIMTEST 
select ( ) 

3 - fid =FID_EF_LARU 

select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
4 -Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD_NUMBER_NOT_AVAIL 
ABLE. 



Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid =FID_DF_SIMTEST 
select ( ) 

3 - fid = FID_EF_CARU 

select 

4 - byte[] datal = { 1,2,3 } 
updateRecord (datal ) 

5 - fid = FID_EF_CARU 

select 

readRecord (data2 ) 
compare datal to data2 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be Identical. 



Selection possibilities 



1 - fid = 


SIMView 


FID_ 


_MF 




select 










2 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select 










3 - fid = 


SIMView 


FID_ 


_DF_ 


.GRAPHICS 


select ( ) 










4 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 










5 - fid = 


SIMView 


FID_ 


_DF_ 


.GRAPHICS 


select ( ) 










6 - fid = 


SIMView 


FID_ 


_MF 




select ( ) 










7 - fid = 


SIMView 


FID_ 


_DF_ 


.GSM 


select 










8 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select 










9 - fid = 


SIMView 


FID_ 


_DF_ 


.TELECOM 


select ( ) 











1 - No exception 

2 - No exception 

3 - No exception 

4 - No exception 

5 - No exception 

6 - No exception 

7 - No exception 

8 - No exception 

9 - No exception 



shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 



thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown. 



No selection of unreachable file 

1 - fid = SIMView. FID_MF 
select ( ) 

2 - fid = SIMView. FID_EF_ACM 
select 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code FILE NOT FOUND. 



6.1.1.3.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1 


N2 


2 


N3 


3 


N4 


4 


N6 


5 


C1 


6 


C2, C3 


Not Tested 
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6.1.1.4 Method status 

Test Area Reference: API_1_SVW_STAT_BSS 

6.1.1.4.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public short status (byte [ ] fci, 

short fciOffset, 
short fciLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: The FCI (FUe Control Information) of the current DF (or MF) is returned in the same format as for a 
SELECT command in case of selecting an MF/DF (described in GSM 03.19 [7], §9.2.1). 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

Parameter errors 

CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci.length, or fciOffset equals fci.length, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SlMViewException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.4.2 Test Suite Files 
Additional requirements for the GSM personalisation: 



Test Script: 


API. 


.1. 


.SVW. 


.STAT 


BSS. 


.l.scr 


Test Applet: 


API. 


.1. 


.SVW. 


.STAT 


BSS. 


.l.java 


Load Script: 


API. 


.1. 


.SVW. 


.STAT. 


BSS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


.SVW. 


.STAT. 


BSS. 


.l.ch 
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6.1.1.4.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIIVI Initialisation 


Responses ignored. 




1 


Status of MF 

byte[] fci = new byte [34] 
fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 

structure. 

<Description of fci: 

XX XX 

XX XX 

3F00 

01 

> 




2 


Status after select EFiccid in MF 

1 - fid = SIMView.FID_DF_GSM 
fciOffset = 

fciLength = 34 
len = select ( ) 

2 - byte[] fci2 = new byte [34] 

len2 = status ( ) 

3 - Compare len and len2 

4 - Compare the len bytes of fci and fci2 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return 22 or more. 

3 - len and Ien2 shall be identical 

4 - fci and fci2 shall be identical 




3 


Status of DFrelecom 

1 - fid = SIMView.FID_DF_TELECOM 

select 

2 - fciOffset = 
fciLength = 100 
status ( ) 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return a value between 22 
and34. 

fci shall contain the entire FCI 
structure (check that returned value 
is equal to 1 3 plus the "length of 
following data" - fci[12]).FID of the 
returned fci (fci[4:5]) is 
FID_DF_TELECOM. 




4 


Status DFtelecom 

fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the first 7 bytes of 
the FCI structure starting at index 
0. 

FID of the returned fci (fci[4:5]) is 
rlU Ur 1 tLtCOM. 




5 


fci is null 

byte[] nullBuffer = null 

fciOffset = 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


fciOffset < 

fciOffset = -1 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




7 


fciLength < 

fciOffset = 
fciLength = -1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


fciOffset + fciLength > fci.length 

fciOffset = 20 
fciLength = 15 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




9 


fciOffset >= fci.length 

fciOffset = 34 
fciLength = 1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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CRR Number 


Test Case Number 


N1 


1-4 


N2 


2,3 


N3 


1,4 


P1 


5 


P2 


6 


P3 


7 


P4 


8, 9 


C1, C2 


Not Tested 



6.1 .1 .5 Method readBinary 

Test Area Reference: API_1_SVW_REDBS_BSS 
6.1.1.5.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public short readBinary (short fileOffset, 

byte [ ] resp, 
short respOffset, 
short respLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: If data can be accessed at the specified offset, the value respOffset plus respLength are returned and the 
data bytes of the currently selected transparent file are returned in resp. 

Parameter errors 

CRRPl: If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

CRRP2: If fileOffset plus respLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SlMViewException.OUT_OF_FlLE_BOUNDARlES. 

CRRP3: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP4: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If respOffset plus respLength is greater than the length of the array resp.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the calUng applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FlLEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SlMViewException.AC_NOT_FULFlLLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for the reading of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.EWALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.5.2 Test Suite Files 

Additional requirements for the GSM personalisation: none. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.1.1.5.3 



API_1_SVW_REDBS_BSS_1 .scr 
API_1_SVW_REDBS_BSS_1 .Java 
API_1_SVW_REDBS_BSS_1 .Idr 
API_l_SVW_REDBS_BSS_l.ch 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored 




1 


Read from EFICCID in MF (Transparent EF) 

1 - fid = SIMView.FID_EF_ICCID 

select 

2 - fileOffset = 

byte [ ] resp = new byte [20] 
resp[0:19] = '55' 
respOffset = 10 
respLength = 10 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 20. 

resp shall contain the entire 

rTintpntQ nf PFK^r^lFl Qtartinn at 

LfUl ILd ILo KJ\ lOOIL-/ OlCtI III 1^ Ctl 

index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

OF FF FF FF FF FF FF FF FF FF 

> 




2 


Read from EFICCID in MF 

resp[0:19] = '55' 

fileOffset = 5 
respOffset = 10 
respLength = 5 
readBinary ( ) 


No exception shall be thrown. 
Shall return 15. 

resp shall contain the last 5 bytes 

of EFICCID starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF 55 55 55 55 55 

> 




3 


Offset into File out of bounds 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




4 


fileOffset + respLength > EF length 

fileOffset = 9 
respOffset = 

resoLenqth — 2 
reaaBmary ( } 


Shall throw 

sim.access.SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


resp is null 

byte[] nullBuffer = null 
fileOffset = 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


respOffset + respLength > resp.length 

fileOffset = 
respOffset = 10 
respLength = 11 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




9 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_LARU 

select 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT. 




10 


Access condition not fulfilled 

1 - fid = DFSIMTTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




11 


EF is invalidated 

1 - fid = EFTNU 
invalidate ( ) 

2 - readBinary () 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 




12 


No EF selected 

1- fid = SIMView.FID_MF 

select ( ) 

2 readBinary () 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 





6.1 .1 .5.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-2 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8, 


C1 


12 


C2 


9 


C3 


10 


C4 


11 


C5, C6 


Not Tested 



6.1.1.6 Method updateBinary 

Test Area Reference: API_1_SVW_UPDBS_BSS 
6.1.1.6.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateBinary ( short fileOffset, 

byte [ ] data, 
short dataOffset, 
short dataLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOfBoundsException, 
SIMViewException 
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Normal execution 

CRRNl : The currently selected transparent file is updated starting at fileOffset, with the string of dataLength bytes 
in the array data starting at dataOffset. 

Parameter errors 

CRRPl: If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

CRRP2: If fileOffset plus dataLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array data is null, an instance of NuUPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.6.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 


API_ 


_1_ 


_svw_ 


_UPDBS_ 


_BSS_ 


_l.scr 


Test Applet: 


APL 


_1_ 


_svw_ 


_UPDBS_ 


_BSS_ 


_l.java 


Load Script: 


API. 


.1. 


.svw. 


.UPDBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


.svw. 


.UPDBS. 


.BSS. 


.l.ch- 
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6.1.1.6.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Update Transparent EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTARU 
select 

3 - fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

4 - fileOffset = 3 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

*-r I^U CALiClJllUI 1 ol ICtll UllUVvll. 

Data in resp[0] shall be '55'. 




3 


1 - fileOffset = 254 

data[0] = '55' 
data[l] = 'AA' 
data[2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary ( ) 
2 - fileOffset = 254 
respOffset = 
respLength = 3 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1] = 'AA' 
resp[^j = DO 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




6 


data Is null 

byte [ ] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 

dataOffset = -1 
dataLength = 10 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 

select ( ) 

2 - fid = FID_EF_LARU 

select 

3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT. 




11 


Access condition not fulfilled 

1 - fid = DFSIMTEST 

select 
fid = EFTNU 
select 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




12 


EF is invalidated 

1 - fid = EFTNR 
invalidate ( ) 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1 .1 .6.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, C6 


Not Tested 



6.1 .1 .7 Method readRecord 

Test Area Reference: API_1_SVW_REDRSBS_BSS 
6.1.1.7.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short readRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: The data bytes from the record, specified by mode and recNumber of the currently selected linear fixed or 
cyclic EF, is read at recOffset. A total of respLength bytes of this data is copied to the array resp at respOffset. 
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CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT: 

- if recNumber is not 0, the record addressed by recNumber will be read; 

- if recNumber is the current selected record will be read; and 

- the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT: 

the next record relative to the current selected record will be selected and read; 

- if no current record is selected, the first record will be selected and read; 

- if the current record pointer is set to the last record for a cyclic EE the record pointer is set to the first record 

and the record is read; 

the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

- the previous record relative to the current selected record will be selected and read; 

- if no current record is selected, the last record will be selected and read; 

- if the current record pointer is set to the first record, for a Unear fixed EE the method responses with an error 
exception and for a cyclic EE the record pointer is set to the last record and the record is read; 

- the current record pointer of any other applet shall not be changed. 

Parameter errors 

CRRPl: If the currently selected EE is hnear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.RECORD_NUMBER_NOT_AVAlLABLE. 

CRRP2: If the currently selected EE is hnear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.RECORD_NUMBER_NOT_AVAlLABLE. 

CRRP3: If the currently selected EE is hnear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EE is linear fixed and the access mode is REC_ACC_M0DE_PREV10US and the 
current record pointer is set to the first record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OE_RECORD_BOUNDARIES. 

CRRP6: If recOffset plus respLength is greater than the record length, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OE_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

CRRP8: If the array resp is null, an instance of NuUPointerException shall be thrown. 

CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPl 1: If respOffset plus respLength is greater than the length of the array resp.length, or respOffset equals 
resp.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 

CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SlMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither hnear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.7.2 Test Suite Files 



Additional requirements for the GSM personalisation: None 



Test Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.java 


Load Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


BSS. 


.l.ch- 



6.1.1.7.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte[] resp = new byte [20] 
respOffset = 
respLength = 10 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute and Current from Linear Fixed 
EF 

1 - fid = DFSIMTEST 

select 

2 - fid = EFLARU 
select ( ) 

// Record pointer not set. 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CDRRENT 

readRecord ( ) 

5 - recNumber = 1 
readRecord ( ) 

6 - recNumber = 

resp[0] = resp[l] = resp[2] = resp[3] = 
'00' 

readRecoird. { ) 


1 - No exception sliall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 
resp[3] = 'AA' 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

6 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 




3 


Read Next from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = 'AA' 

resp[1 ] = 'AA' 

resp[2] = 'AA' 

resp[3] = 'AA' 




4 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




5 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = '55' 

resp[1] = '55' 

resp[2] = '55' 

resp[3] = '55' 




6 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Read Absolute and Current from Cyclic EF 

1 - fid = EFCARU 

select ( ) 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

3 - recNumber = 1 
readRecord ( ) 

4 - recNumber = 

resp[0] = resp[l] = resp[2] = '00 
readRecord ( ) 


1 - No exception sliall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = ' AA' 
resp[1] = 'AA' 
resp[2] = ' AA' 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[^j = 00 




8 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




9 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


No exception shall be thrown. 

resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




10 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




11 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




12 


Read Absolute from Linear Fixed EF beyond 

Records 

1 - fid = EFLARU 

select 

2 - recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE_CDRRENT 

recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 - recNumber = 3 
readRecord ( ) 


1 - No exceptionshall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 

reason code 

RECORD NUIVIBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


No current record in linear fixed EF, read 

current 

1 - fid = EFLARU 

select () // No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset < 

1 - fid = EFLARU 

select ( ) 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




15 


recOffset + respLength > Record Length 

1 - fid = EFLARU 
select 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 2 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




16 


Reading with invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 — mode = 5 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_IVIODE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 




17 


resp is null 

byte [ ] nullBuffer = null 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 
respLength = 10 
readRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




18 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord () 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




1 Q 


icspi-cngiii < u 

respOffset = 
respLength = -1 
readRecord () 


onaii inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




20 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 
java.lang. 

Array 1 ndexOutOf BoundsException . 




21 


EF is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNU 
select ( ) 

3 - respOffset = 
respLength = 4 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILE_INGONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNR 

select ( ) 

2 - respLength = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 

reason code 

AC NOT FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNU 
invalidate () 

2 - readRecord ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 
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CRR Number 




M1 

IM 1 


P-R 7.-1 -1 




P 7 




T R q 


N4 


■linn 


P1 


12 


P9 
r ^ 


1 o 


r O 






c 
o 


pis 


14 


Pfi 


I"! 
1 \J 


P7 


1R 


P8 


17 


P9 


18 


P10 


19 


P11 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.8 Method updateRecord 

Test Area Reference: API_1_SVW_UPDRSBS_BSS 
6.1.1.8.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateRecord ( short recNumber, 

byte mode, 
short recOffset, 
byte[] data, 
short dataOffset, 
short dataLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
SIMViewException 

Normal execution 

CRRNl: dataLength bytes of the record specitied by mode and recNumber of the current selected linear fixed or 
cyclic EF are updated at recOffset, by using the string of bytes in the array data starting at dataOffset. 

CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT and the file is a linear fixed EF: 

- the record addressed by recNumber will be updated; 

- if recNumber is the current selected record will be updated; and 

- the current record pointer shall not change. 

CRRN3: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF: 
the next record relative to the current selected record will be selected and updated; 

- if no current record is selected, the first record will be selected and updated; 

- the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

- the previous record relative to the current selected record will be selected and updated; 
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- if no current record is selected, the last record will be selected and updated; 

if a cyclic EF is updated, the oldest record will be updated independent of the current record pointer and this 
record becomes record number 1 and the current record; 

- the current record pointer of any other applet shall not be changed in case of a linear fixed EF. 

Parameter errors 

CRRPl: If the currently selected EF is Unear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and the 
current record pointer is set to the first record; an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If recOffset plus dataLength is greater than the record lengh, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SlMViewException.lNVALlD_MODE. 

CRRP8: If the currently selected EF is cychc and the mode of record access mode is not 

REC_ACC_MODE_PREVIOUS, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

CRRP9: If the array data is null, an instance of NuUPointerException shall be thrown. 

CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPl 1: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoimdsException shall be thrown. 

Context errors 

CRRCl: If the calhng applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILE_INCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this fiinction, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.EWALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.8.2 Test Suite Files 

Additional requirements for the GSM personalisation: This test is based on the assumption that the contents of the EEs 
in DFsiMTEST are identical to those defined in the default pre-personalisation and the current record pointers have not 
been altered. 



Test Script: 


API_ 


_1_ 


_svw_ 


_UPDRSBS_ 


_BSS_ 


_l.scr 


Test Applet: 


API_ 


_1_ 


_svw_ 


_UPDRSBS_ 


_BSS_ 


_l.java 


Load Script: 


API_ 


_1_ 


_svw_ 


_UPDRSBS_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API. 


.1. 


.svw. 


.UPDRSBS. 


.BSS. 


.l.ck 
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6.1.1.8.3 Test Procedure 



lu 


Description 


API Expectation 


Aruu cxpecTaiion 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

recNuraber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte[] data = new byte [20] 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 

sim. access. SIMViewExceptlon with 
reason code NO_EF_SELEGTED. 




2 


Update Absolute and Current from Linear 
Fixed EF 

1 - fid = DFSIMTEST 
select 

2 - fid = EFLARU 
select ( ) 

// Record pointer not set. 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
data[0:3] = '11' 

recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 
respOffset = 
respLength = 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '11' 
Resp[1] = '11' 
Resp[2] = '11' 
Resp[3] = '11' 


= 4 


3 


Update Current from Linear Fixed EF 

1 - fid = DFSIMTEST 

select 

2 - fid = EFLARU 
select ( ) 

// Set record pointer with mode "next". 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '00' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

// write data with mode "current" 

4 - recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

updateRecord ( ) 

// read result with mode "absolute" 
respOffset = 
respLength = 4 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '22' 
resp[1] = '22' 
resp[2] = '22' 
resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no record 
pointer set 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_LARU 

select 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '33' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
3 - No exception shall be thrown. 
Resp shall be: 

Resp[1] = '33' 
Resp[2] = '33' 
Resp[3] = '33' 




5 


Update Next from Linear Fixed EF, record 
pointer set 

1 - recNumber = 
mode = REC„ACC_MODE_NEXT 
recOffset = 
data[0:3] = M4' 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = '44' 
resp[1] = '44' 
resp[2] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 




dataOffset = 
dataLength = 4 
updateRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


resp[3] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Update Next from Linear Fixed EF, no more 
records 

recNumber = 
mode = REC„ACC_MODE_NEXT 
recOffset = 
data[0:3] = '55' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


Shall throw 

Sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




7 


Update Previous from Linear Fixed EF, no 
record pointer set 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '66' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

/ - rn„rjp - REC ACC "OOE ABSOLUTE CURRENT 
reaaRecora ( } 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

resp shall be: 
resp[0] = '66' 
rpenn 1 — 'Rfi' 
resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, record 
pointer set 

1 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 
readRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown 

2 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '7744' 
Resp[1] = '7744' 
Resp[2] = '7744' 
Resp[3] = '7744' 




9 


Update Previous from Linear Fixed EF , no 
more records 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '88' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 


Shall throw 

sim.access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




10 


Update Previous from Cyclic EF 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_CARU 
select ( ) 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_PREVIOUS 
data [0:2] = resp [0:2] " 'FF' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

5 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 
respLength = 3 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = data[0] 
resp[1 ] = data[1 ] 
resp[2] = data[2] 




11 


Update Absolute from Linear Fixed EF beyond 
Records 

1 - fid = EFLARU 
select ( ) 

2 -recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
dataOffset = 
dataLength = 4 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim.access. SIMViewException with 
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Id 


Description 


API Expectation 


APDU Expectation 




updateRecord ( ) 

2 - recNumber = 3 

updateRecord ( ) 


reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



46 



ETSI TS 101 955 V7.4.1 (2002-03) 



Id 


Description 


API Expectation 


APDU Expectation 


12 


No current record in linear fixed EF, update 
current 

1 - fid = EFLARU 

select () // No curr rec 

2 — irecNumbeir — // cuirir irsc 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


recOffset < 

1 - fid = EFLARU 


1 - No exception shall be thrown. 

2 - Shall throw 






select 

2 ITS c Numbs ~ 1 // ]rsc 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = -1 


sim.access.SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 






dataOffset = 






dataLength = 4 








updateRecord ( ) 






14 


recOffset + dataLength > Record Length 

1 - fid = EFLARU 


1 - No exception shall be thrown. 

2 - Shall throw 






select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 2 


sim. access. SIIVIViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 






dataOffset = 






dataLength = 4 
updateRecord ( ) 






15 


Updating with Invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

3 - mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIIVIViewException with 
reason code INVALID_MODE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 




16 


Updating Cyclic EF with invalid mode 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFCARU 

select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 

dataOffset = 
dataLength = 3 
updateRecord ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

updateRecord ( ) 

5 — recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 

4 - Shall throw 

sim. access. SIIVIViewException with 
reason code INVALID_MODE. 

5 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 




17 


data is null 

byte [ ] nullBuf f er = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




1 R 
1 O 


HataOffoat 11 

Udldwllocl < U 

dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


Qhall thrr\iA# 
Oildll Liiruw 

java.lang. 

Array IndexOutOfBoundsException. 






dataOffset = 
dataLength = -1 
updateRecord ( ) 


ChoM thrnw 

Ol IClll LI II UVV 

java.lang. 

Array IndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 
java.lang. 

Array IndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 


1 - No exception shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 




1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - dataOffset = 
dataLength = 4 
updateRecord ( ) 


2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNU 

select 

2 - recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 

updateRecord ( ) 

3 - fid = EFLNU 

select 

4 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CDRRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




23 


EF is Invalidated 

1 - fid = EFCNR 
invalidate ( ) 

2 - updateRecord ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1.1.8.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3,4, 5, 7, 8, 10 


N2 


2,3 


N3 


5,6 


N4 


7, 8, 9,10 


P1 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.9 Method seek 

Test Area Reference: API_1_SVW_SEEKB_BSS 
6.1.1.9.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public short seek (byte mode, 

byte[] patt. 
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short pattOffset, 
short pattLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: If the pattern in patt with the length pattLength at offset pattOffset is found in the record being specified by 
mode, the current record pointer is set to that record and the record number is returned. The record pointer of any 
other applet is not changed. This will be tested during the testing of the framework. 

CRRN2: If mode is SEEK_FROM_BEGINNING_FORWARD, the search starts with the first record forward 
towards the end of the file. 

CRRN3: If mode is SEEK_FROM_END_BACKWARD, the search starts with the last record backward towards the 
beginning of the file. 

CRRN4: If mode is SEEK_FROM_NEXT_FORWARD, the search starts from the next record after the current 
record pointer forward towards the end of file. If no current record pointer is selected, the search starts with the 

first record. 

CRRN5: If mode is SEEK_FROM_PREVIOUS_BACKWARD, the search starts from the previous record before 
the current record pointer backward towards the beginning of the file. If no current record pointer is selected the 
search starts with the last record. 

CRRN6: If pattern in patt is not found, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

CRRN7: If mode is SEEK_FROM_NEXT_FORWARD and the record pointer is at the last record, an instance of 
SIMViewException shall be thrown. The reason code shall be SlMViewException.PATTERN_NOT_FOUND. 

CRRN8: If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

Parameter errors 

CRRPl: If mode is not between and 3 inclusive (0 = SEEK_FROM_BEGlNNlNG_FORWARD, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

CRRP2: If the pattern array patt is null, an instance of NullPointerException shall be thrown. 

CRRP3: If pattOffset is less than 0, an instance of Array IndexOutOfBoundsException shall be thrown. 

CRRP4: If pattLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If pattLength is greater than the size of the record of the currently selected EE, an instance of 
SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_RECORD_BOUNDARIES. 

CRRP6: If pattOffset plus pattLength is greater than the length of the pattern array patt.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not linear fixed, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 
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CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.9.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.1.1.9.3 



API_l_SVW_SEEKB_BSS_l.scr 
API_l_SVW_SEEKB_BSS_l.java 
API_l_SVW_SEEKB_BSS_l.ldr 
API_1_SVW_SEEKB_BSS_1 .Idr 

Test Procedure 



IH 
lu 


u6Scripiion 


Ari txpeciaiion 


Anuu cxpeciaiion 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

Byte[] patt = new byte [20] 

pattOffset = 
pattLength = 10 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 

sim.access.SIMVIewException with 
reason coae Nu_tr_t3tLtL> i tu. 




2 


Pattern not Found 

1 - fid = DFSIMTEST 
select { ) 

2 - fid = EFLARU 
select ( ) 

3 - patt [0] = 'DA' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

o - onaii Tnrow 

cim arT'Occ ^l^yl\/io\A/FY^'0^^ti^^n \A/ith 

oil 1 1 ■ClOL'^OO.OI IVI V ICVV ^ALrU|JLIUI 1 vvi U 1 

reason code 

PATTERN_NOT_FOUND. 




3 


Seek from Beginning Forward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




4 


Seek from End Backward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_END_BACKWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 1 




5 


Seek from Next Forward 

patt [0:2] = 'AA' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 2 




6 


Last Record, Seek from Next Forward 

mode = SEEK_FROM_NEXT_FORWARD 

seek ( ) 


Shall throw 

sim.access.SIMVIewException with 

reason code 

PATTERN NOT FOUND. 




7 


Seek from Previous Backward 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM„PREVIOUS_BACKWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




8 


First Record, Seek from Previous Backward 


Shall throw 
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Id 


Description 


API Expectation 


APDU Expectation 




SEEK_FROM_PREVIOUS_BACKWARD 
seek ( ) 


sim. access. SIMViewException with 
PATTERN NOT FOUND. 




9 


Pattern not Found (out of reach) 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 
seek ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

PATTERN_NOT_FOUND. 




10 


Invalid mode 

1 - mode = 4 
seek ( ) 

2 - mode = -1 
seek ( ) 


1 - Shall throw 

sim. access. SIIVIViewException with 
reason code INVALID IVIODE 

2 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID MODE 




11 


patt Is null 

byte[] nullBuffer = null 

mode = SEEK FROM_BEGINNING FORWARD 

seek () 


Shall throw 

java.lang.NullPolnterException. 




12 


pattOffset < 

patt[0:2] = '55' 
pattOffset = -1 
pattLength = 3 

mode = SEEK FROM_BEGINNING FORWARD 

seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




13 


pattLength < 

patt[0:2] = '55' 
pattOffset = 
pattLength = -1 

mode = SEEK FROM_BEGINNING FORWARD 

seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




14 


pattLength > size of record 

patt [0:4] = '55' 
pattOffset = 
pattLength = 4 

mode — olljlljK rKOM BejGIJMJMIWG b OKWAKU 

seek ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S 




15 


pattOffset + pattLength > patt.length 

patt[0:2] = '55' 
pattOffset = 1 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




16 


EF Is not Linear Fixed 

1 - fid = EFTNU 

select ( ) 

2 - pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek ( ) 

3 - fid = EFCNU 

select 
seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT 

3 - Shall throw 

sim.access.SIMViewException with 

reason code 

FILE INCONSISTENT 




17 


Access condition not fulfilled 

1 - fid = EFLNR 

select 

2 - patt [0] = '55' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




18 


EF is invalidated 

1 - fid = EFLARU 
select { ) 

2 - invalidate 

3 - patt [0] = ' 55 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

4 - No exception shall be thrown. 
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CRR Number 




M1 

IM 1 






■a 
o 




4 

1" 


N4 


\j 


MR 


7 


NR 

IMD 


9 fi 8 Q 


M7 


C 

o 




Q 
o 


PI 


1fl 


P2 


■\ -l 


P3 


12 


P4 


13 


P5 


14 


P6 


15 


C1 


1 


C2 


16 


C3 


17 


C4 


18 


C5, C6 


Not Tested 



6.1.1.10 Method increase 

Test Area Reference: API_1_SVW_INCR_BS_BS 
6.1.1.10.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
byte [1 resp, 
short respOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
SIMViewException 

Normal execution 

CRRNl: The value in the array incr is added to the value of the last increased / updated record in the currently 
selected cyclic EF. The result is stored in the oldest record and returned in the array resp. The updated record 
becomes record number 1 and is selected as current record. The number of bytes of vaUd data in resp is returned. 

Parameter errors 

CRRPl: If the array incr is null, an instance of NullPointerException shall be thrown. 

CRRP2: If incrOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If incrOffset plus the value 3, is greater than the length of the array incr .length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If the result of the addition is greater than the maximum value of the record (represented by all bytes set to 
'FF'), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.MAX_VALUE_REACHED. 

CRRP5: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP6: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP7: If the remaining length of the array resp at the offset respOffset is less than the length of the record, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 

CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SlMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not cychc, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3 : If increase is not allowed as indicated by the FCI byte 8 (GSM 1 1 . 1 1 : FCI structure of an EF returned by 
the SELECT command), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_D^CONSISTENT. 

CRRC4: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC5: If the currently selected EF is invalidated, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC6: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC7: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.10.2 Test Suite Files 



Additional requirements for the GSM personalisation: None 



Test Script: 


API. 


.1. 


.SVW. 


.INCR. 


BS. 


.BS. 


.l.scr 


Test Applet: 


API. 


.1. 


.svw. 


.D^CR. 


BS. 


.BS. 


.l.java 


Load Script: 


API. 


.1. 


.SVW. 


.D^CR. 


BS. 


.BS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


-SVW. 


.INCR. 


BS. 


.BS. 


.l.ck 



6.1.1.10.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses Ignored. 




1 


No EF selected 

byte[] incr = new byte [4] 
byte[] resp = new byte [4] 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Increase , verify response 

1 - fid = DFSIMTEST 

select 

2 - fid = EFCARU 

select 

3 - //Set both records to 00 00 00 
mode = REC_ACC_MODE_PREVIOUS 

data [0:3] = 
dataOffset = 
dataLength = 3 
updateRecord ( ) 
updateRecord ( ) 

4 - incrOffset = 
incr[2] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
resp[] shall contain {0,0,1 ,0}. 




3 


Increase, verify file 

1 - incrOffset = 1 
incr[2] = 0, incr[3] = 2 
respOffset = 1 
increase ( ) 

2 - resp [3] = 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown. 
resp[] shall contain {0,0,0,3}. 

2 - No exception shall be thrown. 
resp[] shall contain {0,0,3,0}. 
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Id 


Description 


API Expectation 


APDU Expectation 




recOffset = 
respOffset = 
respLength = 
readRecord ( ) 






4 


incr is nuil 

byte[] nullBuffer = null 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

java.lang.NullPointerException. 







incruTTsei < u 

incrOffset = -1 
respOffset = 
increase ( ) 


ondM inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




6 


IncrOffset + 3 > Incr.length 

incrOffset = 2 
respOffset = 
increase ( ) 


Shall throw 
java.lang. 

Array 1 ndexOutOf BoundsException . 




7 


Reach Maximum Value 

incr[0] = incr[l] = incr[2] = 'FF' 
incrOffset = 
respOffset = 
increase { ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

MAX_VALUE_REACHED. 




8 


resp is null 

incr[0] = incr[l] = 0x00' 
incr[2] = '02' 
incrOffset = 
byte[] respNull = null 
respOffset = 
increase ( ) 


Shall throw 

java.lang.NullPointerException. 




Q 

y 


IcSp^TTScI < U 

incrOffset = 
respOffset = -1 
increase ( ) 


onaii inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




10 


respOffset + recordLength > resp.length 

incrOffset = 
respOffset = 2 
increase ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




11 


EF Is not Cyclic 

1 - fid = EFTARU 
select ( ) 

z incrurrseu — u 
respOffset = 
increase ( ) 

3 - fid = EFLARU 
select ( ) 

4 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim.access.SIMViewException with 

rpa<;nn mrlp 

FILE INCONSISTENT. 




12 


Access condition not fulfilled 

1 - fid = EFCNIC 

select 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
AG_NOT_FULFILLED. 




13 


EF is invalidated 

1 - fid = EFCARU 
select ( ) 

2 - invalidate () 

3 - incrOffset = 
respOffset = 
increase ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADIGTION. 

4 - No exception shall be thrown. 




14 


Check Increase not allowed from FCI 

1 - fciOffset = 
fciLength = 8 

select (FID_EF_CINA, f ci . . . ) 

Verify FCI byte 8 (fci[7]) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

Bit 7 of resp[7] shall not be set (0), 
indicating that increase is not 
allowed. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 

6.1.1.10.4 Test Coverage 



54 



ETSI TS 101 955 V7.4.1 (2002-03) 



CRR Number 


Tp^t f^fl^p Niimhpr 


M1 

IM 1 


9 


P1 


4 

1" 


P9 

r ^ 


<j 


1 o 


R 
\j 


P4 


7 


P5 


8 


P6 


9 


P7 


10 


CI 


1 


C2 


11 


C3 


14 


C4 


12 


C5 


13 


C6, C7 


Not Tested 



6.1.1.11 Method invalidate 

Test Area Reference: API_1_SVW_INVL 

6.1.1.11.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the APT 

public void invalidate () 

throws SIMViewException 

Normal execution 

CRRNl: The currently selected EF of the calling applet shall be invalidated, i.e. the flag in the EF file status shall be 
changed accordingly. 

Parameter errors 
No requirements. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the calling applet does not fulfil the access condition, INVALIDATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.AC_NOT_FULFlLLED. 

CRRC3: If the currently selected EF is already invahdated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shaU be SIMViewException.INTERNAL_ERROR. 

6.1.1.11.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_INVL_l.scr 
Test Applet: API_1_SVW_INVL_1 .Java 
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Load Script: API_l_SVW_INVL_l.ldr 
Cleanup Script: API_l_SVW_INVL_l.clr 



6.1.1.11.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - invalidate 


1 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 




2 


Invalidate EF 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFTNR 

select ( ) 

3 — invalidate () 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 




3 


Access condition not fulfilled 

1 - fid = EFCNIV 

select 

2 - invalidate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 

reason code 

AC NOT FULFILLED. 




4 


EF is already invalidated 

1 - fid = EFTNR 

select 

2 - invalidate () 

3 - invalidate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.11.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.1.12 Method rehabilitate 

Test Area Reference: API_1_SVW_REHA 
6.1.1.12.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the APT 

public void rehabilitate ( ) 

throws SIMViewException 

Normal execution 

CRRNl: The currently selected EF of the calling applet shall be rehabiUtated, i.e. the flag in the EF file status shall 
be changed accordingly. 

Parameter errors 
No requirements. 

Context errors 

CRRCl: If the calhng applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 
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CRRC2: If the calling applet does not fulfil the access condition, REHABILITATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is not invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.EWALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SlMViewException.lNTERNAL_ERROR. 

6.1.1.12.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_REHA_l.scr 
Test Applet: API_1_SVW_REHA_1 .Java 

Load Script; APl_l_SVW_REHA_l.ldr 
Cleanup Script: API_l_SVW_REHA_l.ch 



6.1.1.12.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - rehabilitate ( ) 


1 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 




2 


Rehabilitate invalidated File 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCNR 
select 

3 - invalidate 

4 - rehabilitate ( ) 

5 - byte[] incr = new byte [3] = {0,0,1} 

incrOffset = 

byte [ ] resp = new byte[l] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 
resp[] shall contain {0,0,1}. 




3 


Access condition not fulfilled 

1 - fid = EFCNRH 
select ( ) 

2 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED.. 




4 


Rehabilitate validated File 

1 - fid = EFCNR 
select 

2 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.12.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 
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6.1.2 Class SI MSystem 
6.1 .2.1 Method getTheSIMView 

Test Area Reference: API_1_SSY_GETS 

6.1.2.1.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public static SIMView getTheSIMView ( ) 

Normal execution 

CRRNl: returns a reference to class which implements the SIMView interface 

Parameters error 
No requirements 

Context errors 

No requirements 

6.1.2.1.2 Test suite files 

No additional requirements for the GSM personaUsation: 
Test Script: API_I_SSY_GETS_I.scr 
Test Applet: API_I_SSY_GETS_I .Java 

Load Script: API_l_SSY_GETS_l.ldr 
Cleanup Script: API_l_SSY_GETS_l.ch 



6.1.2.1.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reference not equal null after execute 


The returned reference shall be not 
null after execute 




2 


reference to the GSM interface 


Returned a reference to the GSM 
Interface 





6.1.2.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 



6.1.3 Class SIMViewException 

6.1.3.1 Method throwit 

Test Area Reference: API_I_SVE_THITS 
6.1.3.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 
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public static void throwit (short reason) 
throws SIMViewException 

Normal execution 

CRRNl: Throws the JCRE instance of SIMViewException with the specified reason 
CRRN2: Extends javacard.framework.CardRuntimeException 

Parameter errors 

No requirements 

Context errors 

No requirements 

6.1.3.1.2 Test Suite Files 

No additional requirements for the GSM personalisation 
Test Script: API_l_SVE_THITS_l.scr 
Test Applet: API_l_SVE_THITS_l.java 
Load Script: API_l_SVE_THITS_l.ldr 
Cleanup Script: API_l_SVE_THITS_l.clr 



6.1.3.1.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 




2 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 15 




4 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 15 





6.1 .3.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.1.3.2 Constructor 

Test Area Reference: API_l_SVE_COORS 

6.1.3.2.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public SIMViewException (short reason) 
throws SIMViewException 
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Normal execution 

CRRNl: Construct a SIMViewException with the specified reason 

Parameters error 
No requirements 

Context errors 

No requirements 

6.1.3.2.2 Test suite files 

No additional requirements for the GSM personaUsation 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.1.3.2.3 



API_l_SVE_COORS_l .scr 
API_l_SVE_COORS_l .Java 
API_l_SVE_COORS.ldr 
API_l_SVE_COORS.clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


SIMViewException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





6.1.3.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6. 1.3. 3 Reason Codes 

Test Area Reference: API_l_SVE_CONS 

6.1.3.3.1 Conformance Requirement: 

There is no API, only constants. This constants shall comphant to its definition in the API. 
Normal execution 

CRRNl: The Constants of the class SIMViewException shall all have the same name and value defined in the 
GSM03.19 

CRRN2: Constructs SIMViewException a Exception with the specified reason 

Parameters error 

No requirements 

Context errors 
No requirements 
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6.1.3.3.2 Test suite files 
None 

6.1.3.3.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed 

6.2 Package sim.toolkit 

6.2.1 Interface ToolkitConstants 
6.2.1.1 Constants 

Test Area Reference: API_2_TKC_CONS 

6.2.1.1.1 Conformance Requirement: 

There is no API, only constants. This constants shall be compare to its definition in the API. 
Norma! execution 

CRRNl: The Toolkit Constants shall all have the same name and value defined in the GSM03.19 normaUzation. 

Parameters error 

No requirements 

Context errors 
No requirements 

6.2.1.1.2 Test suite files 
None 

6.2.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.2 Interface Toolkitlnterface 
6.2.2.1 Method processToolkit 

Test Area Reference: API_1_TKI_PRTKB 

6.2.2.1.1 Conformance Requirement: 

The method with following prototype shall compliant to its definition in the API. 

public void processToolkit (byte event) 
throws ToolkitException 

Normal execution 

CRRNl: This interface must be implemented by a Toolkit applet (which extends the javacard. framework. Applet 
class) so that it can be triggered by the Toolkit Handler according to the registration information. 
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CRRN2: The Toolkit applet will have to implement the processToolldt shared method so that the following events 
can be notified; 



Event 


Description 


hjVhjJSIl FKUr llihj UOWWliUAU 


Terminal Profile command reception 


EVENT_FORMATTED_SMS_PP_ENV 


03.48 formatted envelope SMS-PP Data 
Download reception 


EVENT_FORMATTED_SMS_PP_UPD 


03.48 formatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_PP_ENV 


Unformatted Envelope SMS-PP Data Download 
reception 


EVENT_UNFORMATTED_SMS_PP_UPD 


Unformatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_CB 


Unformatted Cell Broadcast Data Download 
command reception 


EVENT_MENU_SE LECTION 


Envelope Menu Selection command reception 


hi VhjJM 1 ^MiIjJMU lUJM MIIjLF KhjUUiijo i 


Envelope Menu Selection Help Request 
command reception 


TTIT'TMT' r'HT T ("^^MT'Dl^T 'DV QTM 
111 VHiiN i CiiJ-i J-i CJiN i KU J-i D 1 O -LiYl 


Envelope Call Control by SIM command 
reception 


F^/FMT MO c; HHR T WW '^'^ATV rHMTRHT RV c; TM 
Iij V IijiN ± L 1\J O n^J-Tx -L 1 iH] O OrtoHj i-^^^iN X rxv^ J_i D 1 O -Li 1 


Envelope MO Short Message Control by SIM 

OUI III ildi lU ryoupiiuii 


EVENT_T IMER_EXP I RAT I ON 


Fnvplnnp Timpr Fyniratinn 

1 1 1 V d\_/L/^ 1 1 1 1 ICI 1 ALJII dllL/l 1 


EVENT_EVENT_DOWNLOAD_MT_CALL 


Envelope Event Download - MT call 


EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 


Envelope Event Download - Call connected 


EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 


Event Download - Call disconnected 


EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 


Envelope Event Download - Location status 


EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 


Envelope Event Download - User activity 


EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 


Envelope Event Download - Idle screen available 


EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


Envelope Event Download - Card Reader Status 


EVENT_STATUS_COMMAND 


Status APDU command event 


EVENT_UNRECOGNI ZED_ENVELOPE 


Unrecognized Envelope command reception 



Parameters error 

No requirements 

Context errors 

No requirements 

6.2.2.1.2 Test suite files 
The method is tested in the Framework 

6.2.2.1 .3 Test Coverage 



CRR number 


Test case number 


N1 


Tested in Framework 


N2 


Tested in Framework 



6.2.3 Class EditHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EnvelopeResponseHandler, ProactiveHandler. 

6.2.4 Class EnvelopeHandler 
6.2.4.1 Method getEnvelopeTag 

Test Area Reference: API_2_ENH_GENT 
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6.2.4.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getEnvelopeTag ( ) 

Normal execution 

CRRNl: The method shall return the Envelope BER-TLV tag. 

CRRN2: The Envelope BER TAG is available for all triggered toolkit applets from the invocation to the termination 
of their processToolkit method if the EnvelopeHandler is available. 



Parameters error 
Context errors 

6.2.4.1.2 Test suite files 



Test Script: 


API. 


.2. 


ENH. 


.GENT. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GENT. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GENT. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH 


_GENT_ 


_l.ch 



6.2.4.1.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getEnvelopeTag called just after triggering of the 
application. 


Returns OxD1 




2 


getEnvelopeTag called after a proactive 
command. 


Returns OxD1 




3 


getEnvelopeTag called after a second proactive 
command. 


Returns OxD1 





6.2.4.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


1, 2, 3 



6.2.4.2 Method getltemldentifier 

Test Area Reference: API_2_ENH_GIID 

6.2.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRNl :The method shall return the item identifier byte value. 

CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 
CRRN3: If the element is available it becomes the TLV selected. 
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CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination of 
their processToolkit method if the EnvelopeHandler is available. 

Parameters error 

No requirements. 

Context errors 

CRRCl: The method shall throw ToolkitException (UNAVAILABLE_ELEMENT) if the item identifier TLV is not 
present. 

CRRC2: The method shall throw ToolkitException (OUT_OF_TLV_BOUND ARIES) if the item identifier byte is 
missing in the Item Identifier Simple TLV. 



6.2.4.2.2 Test suite files 



Test Script: 


API. 


.2. 


ENH. 


.GIID. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.ono. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GIID. 


.l.ldr 


Cleanup Script: 


APL 


X 


_ENH. 


.GIID. 


.l.ch- 



6.2.4.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope SMS-PP Formatted with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value FF and second 44 


Returns FF 




3 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value 81 and second 44, 

call twice the method getltemldentifier 


Returns 81 
Returns 81 




4 


Send envelope SMS-PP Formatted with item 
identifier TLV and value of 66. FindTLV with TAG 
02. getltemldentifier and then getValueByte with 
offset 


getltemldentifier=getValueByte 




5 


Send envelope SMS-PP Formatted without item 
identifier TLV and getltemldentifier 


ToolkitException 
(UNAVAILABLE_ELEMENT) 




6 


Send Envelope SMS-PP Formatted with item 
identifier TLV (66), send proactive command. Then 
getltemldentifier 


Returns 66 




7 


Send Envelope SMS-PP Formatted with item 
identifier TLV but without item number 


ToolkitException 
(OUT_OF_TLV_BOUNDARIES) 





6.2.4.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


2,3 


N3 


4 


N4 


6 


CI 


5 


C2 


7 



6.2.4.3 Method getSecuredDataLength 

Test Area Reference: API_2_ENH_GSDL 
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6.2.4.3.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl : The method shall return the length of the secured data contained in a SMS TPDU TLV. 
CRRN2: The length is from the first SMS TPDU TLV. 
CRRN3: The length should not include padding bytes. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_EN V and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN6: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.3.2 Test suite files 

Specific triggering; 

- SMS CB 

- FORMATTED SMS PP UPD 

- UNFORMATED SMS PP ENV 

- For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 

applications. 



Test Script: 


API. 


.2. 


ENH. 


.GSDL_ 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GSDL_ 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GSDL_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GSLD_ 


.l.clr 



6.2.4.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x2A 




2 


Test with TP-OA length of 6 


Returns Ox2A 




3 


Test with TP-OA length of 12 


Returns Ox2A 




4 


Test with RC/CC/DS length of 


Returns 0x10 




5 


Test with RC/CC/DS length of 8 


Returns 0x10 




6 


Test with PCNTR = 


Returns 0x10 
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-7 

1 


1 est WItn rON 1 n = / 


rieturns uxub 




8 


Test with SecuredDataLength = 00 


Returns 0x00 




9 


Test with UserDataLength = 0x33 


Returns 0x33 




10 


Test with UserDataLength = Ox 6C 


Returns Ox 6C 




11 


Test with UserDataLength = Ox 6D 


Returns Ox 6D 




12 


Test with UserDataLength = maximum length: 

0x79 


Returns Ox 79 




13 


Verify it is the first TPDU TLV: 

Send a SMS PP with 2 TPDU TLV and inside two 

different secured data lengths: 5 and 10 


Returns 0x05 




14 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




15 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




16 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




17 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




18 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




19 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




20 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




21 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x00 




22 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x33 




23 


Same test as 7 but with 
FORMATTED SMS PP UPD 


Returns Ox 6C 




24 


Same test as 8 but with 
FORMATTED SMS PP UPD 


Returns Ox 6D 




25 


Same test as 9 but with 
FORMATTED SMS PP UPD 


Returns Ox 79 




26 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




27 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataLength 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


getValueByte returns 0x40 




28 


Send an envelope SMS CB, 
getSecuredDataLength 


ToolkitException 
UNAVAILABLE ELEMENT 




29 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.3.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1,2, 3, 4, 5, 6, 7, 8, 9, 10, 
11,12, 13 


N2 


13 


N3 


6, 7 


N4 


1,2,3, 4, 5, 6, 1, 8, 9, 10, 
11, 12, 13, 25 


N5 


14, 15, 16, 17, 18, 19, 20, 
21 , 22, 23, 24, 25, 26 


N6 


27 


CI 


28 


C2 


29 
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6.2.4.4 Method getSecuredDataOffset 

Test Area Reference: API_2_ENH_GSDO 

6.2.4.4.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the offset of the secured data first byte contained in a SMS TPDU TLV. 
CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 

formatted according to GSM03.48. 

CRRN5: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 

No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.4.2 Test suite files 

Specific triggering: 

SMS CB 

FORMATTED SMS PP UPD 
UNFORMATED SMS PP ENV 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for 
downloading applications. 



Test Script: 


API. 


.2. 


ENH. 


.GSDO. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GSDO. 


.l.java 


Load Script: 


API. 


_2_ 


_ENH 


_GSDO_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GSDO. 


.l.ch 



6.2.4.4.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x21 




2 


Test with TP-OA length of 6 


Returns 0x23 




3 


Test with TP-OA length of 12 


Returns 0x26 




4 


Test with RC/CC/DS length of 


Returns 0x21 




5 


Test with RC/CC/DS length of 8 


Returns 0x29 




6 


Send a SMS PP with 2 TPDU TLV and inside two 
different secured data offsets 


Returns 0x24 ( the first offset ) 
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7 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




8 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x23 




9 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x26 




10 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




11 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x29 




12 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x24 ( the first offset ) 




13 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataOffset 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


Returns 0x40 




1 4 


bend an envelope bMb Od, 
getSecu red DataOff set 


ToolkitException 
UNAVAILABLE ELEMENT 












15 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 




16 


Send an envelope SMS-PP formatted with no 
secured data , getSecuredDataOffset 


Returns 0x21 





6.2.4.4.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1,2, 3, 4, 5, 6,16 


N2 


6, 12 


N3 


1,2, 3, 4, 5, 6, 16 


N4 


7, 8, 9,10,11 


N5 


13 


CI 


14 


C2 


15 



6.2.4.5 Method getTheHandler 

Test Area Reference: API_2_ENH_GTHD 

6.2.4.5.1 Conformance Requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the single system instance of the EnvelopeHandler class. 

CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime Envirormient 
(JCRE) Specification [12]) 

Parameters error 

No requirements 
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Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 



6.2.4.5.2 Test suite files 



Test Script: 


API. 


_2_ 


_ENH_ 


_GTHD_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GTHD. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GTHD. 


.l.ch 



6.2.4.5.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 
GetTheHandler 


The reference returned shall be an 
EnvelopeHandler (checkcast) 




3 


Verify the returned value is not null 
GetTheHandler 


The reference returned shall not be 
null. 





6.2.4.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 
Framework tests and 
insert here cross 

reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 



6.2.4.6 Method getTPUDLOffset 

Test Area Reference: API_2_ENH_GTPO 

6.2.4.6.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getTPUDLOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the TPUDL offset in a SMS TPDU TLV. 

CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV. 
CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD. 
CRRN5: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_ENV. 
CRRN6: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_UPD. 
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CRRN7: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 

No requirements 

Context errors 

CRRCl: The method shall thrown ToolldtException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) if the TPUDL field does not 
exist. 

6.2.4.6.2 Test suite files 

Specific triggering: 

FORMATTED SMS PP UPD 
UNFORMATTED SMS PP UPD 
UNFORMATTED SMS PP ENV 
SMS CB 



Test Script: 


API. 


.2. 


.ENH. 


.GTPO. 


.l.scr 


Test Applet: 


API. 


.2. 


.ENH. 


.GTPO. 


.l.java 


Load Script: 


API. 


.2. 


.ENH. 


.GTPO. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.ENH. 


.GTPO. 


.l.clr 



6.2.4.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns OxOD 




2 


Test with TP-OA length of 6 


Returns OxOF 




3 


Test with TP-OA length of 12 


Returns 0x12 




4 


Send a SMS PP with 2 TPDU TLV and inside two 
different UDL offsets 


Returns 0x1 ( the first offset ) 




5 


Same test as 1 but with 
FORIVIATTED SIVIS PP UPD 


Returns OxOD 




6 


Same test as 2 but with 
FORIVIATTED SMS PP UPD 


Returns OxOF 




7 


Same test as 3 but with 
FORMATTED_SMS_PP_UPD 


Returns 0x12 




8 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x1 ( the first offset ) 




9 


Same test as 1 but with 
UNFORMATTED SMS PP UPD 


Returns OxOD 




10 


Same test as 2 but with 
UNFORMATTED SMS PP UPD 


Returns OxOF 




11 


Same test as 3 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 




12 


Same test as 4 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 ( the first offset ) 




13 


Same test as 1 but with 
UNFORMATTED SMS PP ENV 


Returns OxOD 




14 


Same test as 2 but with 
UNFORMATTED SMS PP ENV 


Returns OxOF 




15 


Same test as 3 but with 
UNFORMATTED SMS PP ENV 


Returns 0x12 




16 


Same test as 4 but with 
UNFORMATTED SMS PP ENV 


Returns 0x1 ( the first offset ) 




17 


Verify after call of the method the current TLV is the 
TPDU TLV: 

findTLV device identities, getTPUDLOffset and then 


Returns 0x40 
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getValueByte to verify that the current TLV is the 
TPDU TLV 






18 


Send an envelope SMS CB, getTPUDLOffset 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 




11,12, 13, 14, 15, 16, 17 


N2 


4 


N3 


1, 2, 3, 4, 17 


N4 


5, 6, 7, 8 


N5 


13, 14, 15, 16 


N6 


9, 10, 11, 12 


N7 


17 


CI 


18 


C2 


Don't no how to test 



6.2.4.7 Method getLength 

Test Area Reference: API_2_ENH_GLEN 

6.2.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl; returns the length in bytes of the TLV hst. 

Parameter Error 

No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.4.7.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_GLEN_l.scr 
Test Applet: API_2_ENH_GLEN_1 .Java 

Load Script: API_2_ENH_GLEN_l.ldr 
Cleanup Script: APl_2_ENH_GLEN_l.ch 
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6.2.4.7.3 Test Procedure 



IH 
lu 


uescripiion 


Ari cxpeciaiion 


Aruu cxpeciaiion 


1 


Send an envelope SMS PP with BER length of 
0x31 


Result of getLengthO is 0x0031 




2 


Send an envelope SMS PP with BER length of 
0x7F 


Result of getLengthO is 0x007Fh 




3 


Send an envelope SMS PP with BER length of 

81 80 


Result of getLengthO is OxOOSOh 




4 


Send an envelope SMS PP with BER length of 
81 FC 


Result of getLengthO is OxOOFCh 





6.2.4.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4 


CI 


Does not apply for 
EnvelopeHandler 



6.2.4.8 Method copy 

Test Area Reference: API_2_ENH_COPY_BSS 

6.2.4.8.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [ ] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl : copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.8.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_COPY_BSS_l.scr 
Test Applet: API_2_ENH_COPY_BSS_l .java 
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Load Script: API_2_ENH_COPY_BSS_l.ldr 
Cleanup Script: API_2_ENH_ COPY _ BSS _1 .clr 



6.2.4.8.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset ^ dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

DstBuffer.length = 5 
r)stnffc!ot = T 

o U W J- J- o tJ U — J 

DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

dstBuffer.length = 5 

dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the simple TLV list 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


ToolkitException.OUT_OF_TLV_BO 
UNDARIES is ttirown 




8 


Successful call, dstBuffer is the whole buffer 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 0X0009 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X01 04 




15 


Compare the whole buffer 


Result of arrayCompareO is 




16 


Successful call, copy with length =0 

dstBuffer.length = 260 
dstOffset = 260 
dstLength = 


Result of copyO is 0x1 04 





6.2.4.8.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for 




EnvelopeHandler 
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6.2.4.9 Method findTLV 

Test Area Reference: API_2_ENH_FINDBB 

6.2.4.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV Ust (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUm)_CR_NOT_SET when Comprehension Required 

flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRPl: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.9.2 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


.2. 


ENH. 


.ENH_FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.ENH_FINDBB. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.ENH_FINDBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.FINDBB_l.ch- 





6.2.4.9.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trig the applet with SMS PR including one more 
tag 02 and one TAG 04 






1 


Invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_P 
ARAMETER is thrown 




2 


Search 1st TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthQ method 


Result is 0x02 




4 


Search 2nd TLV 

Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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5 


Call the getValueLengthO method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 






Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = 02h 

Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




10 


Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 

Tl \/ FOI INin PR MOT QFT 




11 


Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV FOUND CR NOT SET 




12 


Search tag 81 h 

Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.4.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for 




EnvelopeHandler 



6.2.4.10 Method getValueLength 

Test Area Reference: API_2_ENH_GVLE 
6.2.4.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 

Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC 1 : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.4.10.2 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


.2. 


ENH. 


.GVLE. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GVLE. 


.l.java 


Load Script: 


API. 


_2_ 


_ENH_ 


_GVLE_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GVLE. 


.l.clr 



6.2.4.10.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 






1 


getValueLengthO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 








getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 








getValueLength ( ) 


Result is 0X00C8 





6.2.4.10.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4 


C1 


Does not apply for 
EnvelopeHandler 


C2 


1 



6.2.4.11 Method getValueByte 

Test Area Reference: AP1_2_ENH_GVBYS 
6.2.4.11.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUNDARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVA1LABLE_ELEMENT. 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



76 



ETSI TS 101 955 V7.4.1 (2002-03) 



6.2.4.11.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.11.3 



API_2_ENH_GVBY.scr 
API_2_ENH_GVB Y_l .Java 
API_2_ENH_GVBY.ldr 
API_2_ENH_GVB Y_l .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 
Valued 02 ... 






1 


getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




2 


Search TLV 02h 








getValueByte (2) 


ToolkitException. OUT OF TLV 
BOUNDARIES is tiirown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 




5 


Search TLV 33h 








getValueByte (7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xC8 





6.2.4.1 1 .4 Test Coverage 



CRR number 


Test case number 


Ml 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for 




EnvelopeHandler 


C2 


1 



6.2.4.12 Method copy Value 

Test Area Reference: API_2_ENH_CPYVS_BSS 
6.2.4.12.1 Conformance Requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 



Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
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CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolldtException shall be 
thrown. The reason code shall be ToolldtException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolldtException shall be thrown. The reason code shall be 
ToolldtException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolldtException shall be thrown. The reason code shall 
be ToolldtException UNAVAILABLE_ELEMENT. 

6.2.4.12.3 Test Suite files 

Specific triggering: None 
Test Script: 



Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.12.3 



API_2_ENH_CPYVS_BSS_1 .scr 
API_2_ENH_CPYVS_BSS_1 .Java 
API_2_ENH_CPYVS_BSS_1 .Idr 
API_2_ENH_CPYVS_BSS_l.ch- 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset ^ dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
dstBuffer.length = 15 

dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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dstLength = 1 






9 


dstLength > TLV length 

valueOffset = 

^ 4- 1 1 -P -P -v n nnn4-V\ 1 C 

ciST^tiu r rer . xengtn — lo 

dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 








copyValue ( ) 


ToolkitException.UNAVAILABLE 

ELEIVIENT is thrown on the 
copyValueO method 




12 


Search TLV 06h 








Successful call 


Result of copyValueO is 0x0006 






valueOffset = 








dstBuff er . length = 6 








dstOffset = 








dstLength = 6 






1 3 


Comnarp buffer 

buffer = 81 11 22 33 44 F5 


Ppciiit ic nnh 




14 


Initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValueO is 0x0007 






valueOffset = 1 








dstBuffer. length = 20 








asturrset — J 








dstLength = 4 






15 


Compare buffer 

buffer = 

cc cc c;c; -1-1 99 

33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuff er . length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.4.12.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for 




EnvelopeHandler 


C2 


11 



6.2.4.13 Method compare Value 

Test Area Reference: API_2_ENH_CPRVS_BSS 
6.2.4.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



79 



ETSI TS 101 955 V7.4.1 (2002-03) 



Normal execution 

Compares the last found TLV element with a buffer: 
CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is nuU NuUPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of TooUdtException shall be 
thrown. The reason code shall be TooUdtException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
TooUdtException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVA1LABLE_ELEMENT. 

6.2.4.13.3 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


.2. 


ENH. 


.CPRVS. 


.BSS. 


.l.scr 


Test Applet: 


APL 


_2_ 


_ENH_ 


_CPRVS_ 


_BSS_ 


_l.java 


Load Script: 


API. 


_2_ 


_ENH 


_CPRVS_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.CPRVS. 


.BSS. 


.l.ch 



6.2.4.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








compareValue ( ) with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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cC'mpareOf f set - 
compare ^engrn -1 






J _ 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
compareBu f fer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBu f fer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES Is thrown 




9 


compareLength > TLV length 

valueOffset = 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 7 


ToolkltException.OUT OF TLV 
BOUNDARIES Is thrown 




10 


valueOffset + compareLength > TLV length 

valueOffset = 2 
compareBuf fer . length = 15 

compareOf f set = 
compareLength = 5 


ToolkltException.OUT OF TLV 
BOUNDARIES Is thrown 




11 


Search TLV 01 h 


Result Is TLV NOT FOUND 






compareValue ( ) 


ToolkltException.UNAVAILABLE 
ELEMENT Is thrown 




12 


Search TLV 06h 








Initialise compareBuffer 

compareBuf fer = 
81 11 22 33 44 F5 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result Is OOh 




13 


Initialise compareBuffer 

compareBuffer 
• 11 22 33 44 F5 








Compare buffers with same parameters 


Result Is -1 




14 


Initialise compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result Is -1 




\ 


iniiiaiise coinpareDUTTer 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








f\YV\T\^Y^ l\i iff Are 

v^uinpare uuTTers 

vslusOf f sst — 1 
compareOf f set = 4 
compareLength = 5 


rieSUli IS uun 




16 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 10 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result Is +1 




17 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 12 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue with length =o 

CompareBuf fer . length = 15 

CC'mpareOf f set - 15 
Comparerengun 


Result of compareValueO Is 
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n n iiuiiiuci 


Toct f^aco niimKoi' 

1 col l#C10C llUlllli't?! 


N1 


12 15 


N2 


13, 16, 18 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeHandler 


C2 


11 



6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: API_2_ENH_FACYB_BS 
6.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 

short dstOffset) 
throws java . lang . NullPointerException, 
java . lang .Array IndexOutOfBoundsExcept ion, 

ToolkitException 

Normal execution 

CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.14.3 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


_2_ 


_ENH_ 


_FACYB_ 


_BS_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.FACYB. 


.BS. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.FACYB. 


.BS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.FACYB. 


.BS. 


.l.clr 
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6.2.4.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 value 01 02... 






1 


FindAndCopyVaiueQ with a null dstBuffer 


NullPointerException is thrown 




o 

d. 


dstOiTset £. astDUtter.iengtn 

tag = 06h 

dstBuff er . length = 6 
dstOffset = 06 


Array inaexuuiUTBOunastxcepiio 
n is thrown 




o 


dstBuff er . length = 06 

dstOffset = -1 


rti 1 dy 1 1 IUcaV^UI^I DUUi IUoCAL'C;pLIU 
n ic thrA\A/n 

II lo LI II LfVVI 1 




4 


length > dstBuffer.length 

dstBuff er . length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 






findAndCopyValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 




- 


Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

1 dy — U Oil 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue () is 

UUUb 




8 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

U.S t DUX I e IT . ±engti.n — iz 
dstOffset = 2 


Result of findAndCopyValue () is 
0008 




1 u 


O/imnarA hi iff At* 
ouiiipdrc uuiici 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


rlcbUll lo UUII 




1 1 


Successful call 

tag = 02h 

Hc:-|-Rii-F-Fei"r l^nrr-hVi — 9 
UoL-rJU-L-LtrJ- .-LCliyL-il — 

dstOffset = 


Result of findAndCopyValue () is 
0002 




12 


Compare buffer 

buffer = 83 81 


Result is OOh 




1 


Successful call (with tag 82h) 

tag = 82h 

dstBuffer.length = 02 
dstOffset = 


Result of tindAndOopyvaiue () is 
0002 




14 


Compare buffer 

buffer = 83 81 


Result is OOh 




15 


Successful call (with tag B3h) 

tag = B3h 

dstBuffer.length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 




16 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 
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CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




EnvelopeHandler 



6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ENH_FACYBS_BSS 
6.2.4.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV hst and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVA1LABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAlLABLE. 

6.2.4.15.3 Test Suite files 

Test Script: API_2_ENH_FACYBS_BSS_l.scr 
Test Applet: API_2_ENH_FACYBS_BSS_1 .java 
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Load Script: API_2_ENH_FACYBS_BSS_l.ldr 
Cleanup Script: API_2_ENH_FACYBS_BSS_l.clr 



6.2.4.15.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


Array! ndexOutOf Bou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset ^ Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = —1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


T" II ■ 1 i"~ ^^1 i^n i~~ ^ni \ / 

ToolkitException.OUT_OF_TLV_ 
BOUNDARIES IS thrown 




9 


dstLength > Value length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 







Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 06 
dstOffset = 
dstLength = 06 


Result of findAndCopyValueO is 
6 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = 06h, occurrence = 1 
valueOffset = 2 


Result of findAndCopyValue () is 

0007 
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dstBuffer. length = 12 
dstOffset = 3 
dstLength = 04 






15 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




1 o 


OUCCeSSTUI Call 

tag = 02h, occurrence = 1 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 2 


riesuiT OT TinaMnaoopy vaiue^j is 
0002 




1 / 


^f\tm no »*«^ |%i iff Ai* 

Ouinpare uuirer 

buffer = 83 81 55 ... 55 


riSSUIl IS uun 




i Q 
\ O 


ouccessTui call 

tag = 02h, occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 2 


riesuit OT TinaAnuLrOpy vaiue(j is 
0002 




19 


Compare buffer 

butter = zz 44 55 ... 55 


Result is OOh 




20 


Successful call (with tag 82h) 

tag ^ 82h 
occurrence ^ 1 
valueOffset = 
dstBuff er . length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




21 


Compare buffer 

Durrer — oj ol oo ... oo 


Result is OOh 




22 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




23 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




24 


Successful call, findAndCopyValue with 
length =0 

DstBuffer . length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue () is 
12 





6.2.4.15.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18, 24 


N4 


20, 21, 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeHandler 



6.2.4.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ENH_FACRB_BS 
6.2.4.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 86 ETSI TS 101 955 V7.4.1 (2002-03) 



public byte f indAndCompareValue (byte tag, 

byte [ ] compareBuf fer, 
short compareOf f set) 
throws java . lang . NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.4.16.3 Test Suite files 



Test Script: 


API. 


_2_ 


_ENH_ 


_FACRB_ 


_BS_ 


_l.scr 


Test Applet: 


API. 


.2. 


.ENH. 


.FACRB. 


.BS. 


.l.java 


Load Script: 


API. 


.2. 


.ENH. 


.FACRB. 


.BS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.ENH. 


.FACRB. 


.BS. 


.l.ch- 



6.2.4.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset ^ compareBuffer.length 

tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 12 

compareOffset = -1 


ArraylndexOutOfBoundsExceptio 

n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 







ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 87 ETSI TS 101 955 V7.4.1 (2002-03) 





findAndCompareValueQ 

tag = 03h 


aI|^:4^«<mam4-:mm iikia\/aii aoi r 

Toolkit Exception. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthQ method 


ToolkitException .UNAVAILABLE 
ELEMENT is thrown. 




7 


Initialise compareBuffer 

compareBuf fer = 81 11 22 33 44 F5 








Compare buffers 


Result is OOh 






tag - 6h 








compareOf f ser 






8 


Verify current TLV 

getValueLength ( ) 


Result is 06 




9 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




10 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 


Result is OOh 






compareOf f set = 2 






12 


Initialise compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 


Result is OOh 






compareOf f set = 2 






13 


Initialise compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 


Result is +1 






compareOf f set = 2 






14 


Initialise compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 


Result is -1 






compareOf f set = 2 






15 


initialise compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 


Result is OOh 






tag = 02h 








compareBuf fer . length = 12 

compareOf f set = 






16 


Initialise compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 


Result is OOh 






Tag = B3h 








CompareBuf fer . length = C4 








CompareOf f set = 







6.2.4.16.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 




EnvelopeHandler 
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6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ENH_FACRBBS_BSS 
6.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.4.17.3 Test Suite files 



Test Script: 


API. 


_2_ 


_ENH_ 


_FACRBBS_ 


_BSS_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.clr 
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6.2.4.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 








Tag 33, Length C4 value 01 02... 






1 


findAndCompareValueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


Array IndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 6 
compareOffset = -1 

L. UlLLLJcL J- fc! J-itJl ly L 11 — -L 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 

O Ulll^Jci J- 1! J-ifciliy L. 11 — D 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 

compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset ^ Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

valueOffset = 

L- U i L L j-J cil-t;lIjU.J-J-t!J-.-LC!liyL.ll — -LvJ 

compareOffset = 

compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_P 
ARAMETER is thrown 




12 


Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = 06h 


ToolkitException. UNAVAILABLE 
_ELEIVIENT is thrown 






occurrence = 2 








Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
PI FMFNT !«; thrown 

l_L_l_IVIL_l^ 1 lO LI II WWII. 




13 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F5 









findAndCompareValueQ 


Roci j|t is OOh 

1 IWOUIL lO WWII 






tag = 06h, occurrence = 1 








valueOffset = 








compareOffset = 
compareLength = 6 






14 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




15 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




16 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 
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Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuf f er = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 


Result is OOh 






valueOffset = 2 








compareOf f set = 3 








compareLength = 4 






18 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 









Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




en 


Initialico /^nmnfii'oRi iffoi* 

IIIIIICIIIOC 1 l|^CII t?DU 1 Id 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








1 II lUnI lU wUI 1 lUdl C V dlUC^^ 


Daci lit ic nnh 

ricoUll lb UUII 






tag = 02h, occurrence = 1 








valueOffset = 








cornpareOf f set = 








compareLength = 2 






c. \ 


Initialiea /^nmnsiroRiiffoi' 
iiiiiiaiidc i#uii ludi cDUi Id 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








1 II lUMI lUOUilllJcll JS V dlUt;^^ 


Roci lit ic nnh 

rlcbUll lb UUil 






tag = 02h, occurrence = 2 








valueOffset = 








compareOf f set — 








compareLength = 2 






00 

C.C. 


Initialieo /^nmnfiroRiiffoi* 
iiiiiidiidc i#uii ludi cDU 1 Id 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








f i nrl A nHr^rnnnafA \/cili 

1 11 lUMl lUOUllllJdlt; V dlUc^y 


Dqoi I It io i 
ricbUll lb 1 






tag — 02h, occurrence = 2 








valueOffset = 








c omp areOffset — 








compareLength = 2 








iiiilidiiot; oi/iii|JdicDUiid 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Qii/^/^oeef 1 il /^£ill /ufith tan n9h\ 

OUl#i#C90IUI i#dll ^Wllll Idy 


Roci lit ic nnh 

ncbUll lb UUI 1 






tag = 02h, occurrence = 1 








valueOffset = 








compar eBu ffer . length = 12 








compareOf f set = 








compareLength = 2 






OA. 


Initisilico ^nirmsii'oRi iffoi* 
iiiiiidiioc i^ui 1 i|i^ai t?DU i Id 

compareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 


Result is OOh 






tag = B3h, occurrence = 1 








valueOffset = 








compareBuf fer . length = 00C4 








compareOf f set = 
compareLength = 00C4 






25 


Successful call, findAndCompareValue with 
length =0 

DstBuf fer . length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueO 
is OOh 
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6.2.4.17.4 Test Coverage 



nRR niimhpr 


TpQt cfl^p niimhpr 


M1 
i>i 1 


1 P 
1 ^ 


MP 


14 

1 *T 




1*^ 17 pn P1 9^ 


N4 


19, 15 


N5 


16, 18, 22 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4,5,6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




EnvelopeHandler 



6.2.5 Class EnvelopeResponseHandler 
6.2.5.1 Method getTheHandler 

Test Area Reference: API_2_ERH_GTHD 

6.2.5.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the single system instance of the EnvelopeResponseHandler class. 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]) 

Parameter errors 

No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no more 
available 

6.2.5.1.2 Test suite files 

Test Script: API_2_ERH_GTHD_l.scr 

Test Applet: AP1_2_ERH_GTHD_1 j ava 

Load Script: API_2_ERH_GTHD_l.ldr 

Cleanup Script: API_2_ERH_GTHD_l.clr 
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6.2.5.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 

getTheHandler 


The reference returned shall be an 

EnvelopeResponseHandler 

(checkcast) 




3 


Verify the returned value is not null 

getTheHandler 


The reference returned shall not be 
null. 




4 


getTheHandler, then send a proactive 
command, and then, appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





6.2.5.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 

Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 


C2 


4 



6.2.5.2 Method post 

Test Area Reference: API_2_ERH_POSTB 

6.2.5.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post (byte statusType) 
throws ToolkitException 

Normal execution 

CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command). 

CRRN2: The byte statusType is SWl of the status. 

CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME. 

CRRN4: The SIM TooUdt Framework shall take the optional Application Data posted by the triggered toolkit applet 
if present, secure and send the response packet the SIM Toolkit Framework will return the response APDU 
defined by the toolkit applet. 

Parameter error 

No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

6.2.5.2.2 Test suite files 
Specific triggering: Call control 
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Test Script: 


API. 


.2. 


.ERH. 


.POSTB. 


.l.scr 


Test Applet: 


API. 


.2. 


.ERH. 


.POSTB. 


.l.java 


Load Script: 


API. 


.2. 


.ERH. 


.POSTB. 


.l.ldr 


Cleanup Script: 


API. 


_2. 


.ERH. 


.POSTB. 


.l.clr 



6.2.5.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then post 

(the handler is empty) 




9000 


2 


Fill the handler ( appendTLV to have bytes 

in it ) and then post data with status 

9F 




9FFD data are retrieved with GET 
RESPONSE command 


3 


Verify that after a post the handler is no 
more available 

appendTLV, post and then appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown on the second 
appendTLV 




4 


construct the response (appendTLV with 
0x10 data) and post it with status 9E and 
then send a display text 




9E12 and posted data retrieved by a 
GET RESPONSE with status 911 3 
and display text retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post 

getTheHandler and post , then send a 

display text 




91 13 and display text is retrieved by 
a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandler, appendTLV, send a 
display text, post. 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 




7 


Verify that the handler is no more available 
after a post 

getTheHandler, appendTLV, post with 
status 9E, post with status 9F 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 


9E12 and posted data retrieved by a 
GET RESPONSE 



6.2.5.2.4 Test Coverage 



GRR number 


Test case number 


N1 


3, 4, 7 


N2 


1, 2, 4, 7 


N3 


4, 5 


N4 


To be checked in 




Framework tests and 




insert here cross 




reference 


CI 


6 



6.2.5.3 Method postAsBERTLV 

Test Area Reference:API_2_ERH_POSTBB 
6.2.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV (byte statusType, 

byte tag) 
throws ToolkitException 

Normal execution 

CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet. 
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CRRN2: The byte statusType is SWl of the status 

CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the ME. 
CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV Ust. 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolldtException (HANDLER_NOT_AVAILABLE) if the handler is busy. 
6.2.5.3.2 Test suite files 



Specific triggering: Call control 



Test Script: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.java 


Load Script: 


API. 


.2. 


.ERH. 


.POSTBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.ERH. 


.POSTBB. 


.l.ch 



6.2.5.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then postAsBERTLV 

(the handler is empty) 




9F02 data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 and the 
length is 00 


2 


Fill the handler and then postAsBERTLV 
the data with status 9F, and tag 33 




9FFF data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 


3 


appendTLV, postAsBERTLV and then 
appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown on the second appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and postAsBERTLV it with 
status 9E, tag 75 and then send a display 
text 




9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
75 with status 91 13 and 
display text retrieved by a 
FETCH 


5 


getTheHandler and postAsBERTLV, then 
send a display text 




9E02 and posted data 
retrieved by a GET 
RESPONSE the tag 33 (and 
the length 00) with status 
9113 and display text is 
retrieved by a FETCH 


6 


Verify it is not possible to postAsBERTLV 
after a proactive command 

getTheHandler, appendTLV, send a 
display text, postAsBERTLV. 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
tlirown on the postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLV 

getTheHandler, appendTLV (with data 
length = 0x10, postAsBERTLV with status 

9E, tag 56, postAsBERTLV with status 
9E, tag zb 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown on the second postAsBERTLV 


9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
56 with status 9000 
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6.2.5.3.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 7 


N2 


1, 2, 4, 7 


N3 


4,5 


N4 


2, 4, 7 


C1 


6 



6.2.5.4 Method getLength 

Test Area Reference: API_2_ERH_GLEN 
6.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl: returns the length in bytes of the TLV hst. 

Parameter errors 

No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.5.4.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.GLEN. 


.l.scr 


Test Applet: 


API. 


.2. 


_ERH. 


.GLEN. 


.l.java 


Load Script: 


API. 


.2. 


.ERH. 


.GLEN. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.GLEN. 


.l.ch 



6.2.5.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthQ is 




2 


appendTLV with length of 7 

getLength ( ) 


Result of getLengthQ is 9 




3 


Clear the handler and appendTLV with Length 
of 250 

getLength ( ) 


Result of getLengthQ is 253 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLengthQ is 81 h 




5 


Build a 80h Envelope response handler 

getLength ( ) 


Result of getLengthQ is 83h 





Note : Test case 3 is limited to 253 and not 256 because the current 03.19 [7] is not clear enough on this point. So this 
test allows the two possible implementations. 
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6.2.5.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5 


C1 


Does not apply for 
Envelope response 
handler 



6.2.5.5 Method copy 

Test Area Reference: API_2_ERH_COPY_BSS 
6.2.5.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV hst contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 

ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.5.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.COPY. 


BSS. 


.l.scr 


Test Applet: 


APT 


_2_ 


_ERH 


_COPY_ 


BSS_ 


_1 .java 


Load Script: 


API. 


_2_ 


_ERH_ 


_COPY_ 


_BSS_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.COPY. 


BSS. 


.l.ch 
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6.2.5.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with value length of 7 
NULL as Darameter to dstBuffer 


NiillPnintprFxppntion i<5 thrnwn 

1 ^ LI 1 1 1 W 1 1 1 LW 1 i^yV^wU LI V 1 1 lO LI 1 1 W V ¥ 1 1 




2_ 








dstOffset ^ dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 

dstOffset = 
dstLsri'^th — 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 

dstOffset = 

HstTienrrth = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




a 

o 


^iippp^^fiil r^ll H^tRiiffpr thp whnip hiiffpr 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 






Q 


f^nmnarp thp hiiffpr 






1 n 

1 u 


dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Roci lit nf /^r\r\\t(\ ic 1 Q 




1 1 


Compare the whole buffer 


Rp<^ijlt of arravCnmnarpn i*? 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copy is 15 





6.2.5.5.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 
Envelope response 
handler 



6.2.5.6 Method findTLV 

Test Area Reference: API_2_ERH_FINDBB 
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6.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV(byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV hst (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRPl: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.6.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


.ERH_FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


.ERH_FINDBB. 


.l.java 


Load Script: 


API. 


.2. 


.ERH_FINDBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.ERH_FINDBB. 


.l.clr 



6.2.5.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_P 

ARAMETER is thrown 




2 










Search 1st TLV 


Result is TLV_FOUND_CR_SET 






Tag = Olh 








Occurrence = 1 






3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result Is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 


Result Is TLV_NOT_FOUND 
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Tag - 3h 






7 


Call the getValueLengthQ method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence ^ 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthQ method 


ToolkitException.UNAVAILABLE 
ELEMENT is ttirown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 

TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV FOUND CR NOT SET 




12 


Search tag 81 h 

Tag - 81h 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.5.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for 




Envelope response 




handler 



6.2.5.7 Method getValueLength 

Test Area Reference: API_2_ERH_GVLE 
6.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRC 1 : if the handler is busy an instance of TooUdtException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.5.7.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.GVLE_ 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.GVLE_ 


.l.java 


Load Script: 


API. 


_2_ 


_ERH 


_GVLE_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.GVLE_ 


.l.clr 



6.2.5.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 02 02 02 02 
f IndTLV with TAG 03 






getValueLengthQ 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


appendTLV with TAG CD and length GO 








Search TLV ODh 








getValueLength { ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and append TLV with TAG 
OD and length 0x7F 






Search TLV ODh 








getValueLengthO 


Result is 7Fh 




5 


Clear the handler and append TLV with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength ( ) 


Result is 80h 




6 


Clear the handler and append TLV with TAG 
OD and length OxFI 








Search TLV ODh 








getValueLength ( ) 


Result is F1 h 





6.2.5.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


1 



6.2.5.8 Method getValueByte 

Test Area Reference: API_2_ERH_GVBYS 
6.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of TooUdtException shall be thrown. The reason code 
shall be TooUdtException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
TooUdtException H ANDLER_NOT_AV AIL AB LE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.8.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.GVBYS. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.GVBYS. 


.l.java 


Load Script: 


APL 


_2_ 


_ERH 


_GVBYS_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ERH_ 


_GVBYS_ 


.l.clr 



6.2.5.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 82 02 81 82, appendlLV 81 03 11 
22 FE 
fIndTLV with TAG 03 








getValueByte (0) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte (2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLV with TAG OD, Length 0x7E, Value: 
00, 01,..., 7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLV with TAG OD, 
Length 0x80, Value: 00, 01, 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 




8 


clear the handler, appendTLV with TAG OD, 
Length OxFI, Value: 00, 01, FO 








getValueByte (FO) 


Result is FOh 
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6.2.5.8.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


1 



6.2.5.9 Method copyValue 

Test Area Reference: API_2_ERH_CPYVS_BSS 
6.2.5.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.9.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_CPYVS_BSS_l.scr 
Test Applet: API_2_ERH_CPYVS_BSS_1 .java 

Load Script: API_2_ERH_CPYVS_BSS_l.ldr 
Cleanup Script: API_2_ERH_CPYVS_BSS_l.clr 
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6.2.5.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: CD and length 16 
Select Text String TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 

doL.J-iCiiyL.il — D 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler, appendTLV with TAG: OD 
and length 6 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 

dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








copyValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 
Select Text String TLV 








valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer.length = 20 

dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



104 



ETSI TS 101 955 V7.4.1 (2002-03) 



15 


Compare buffer 

buffer = 

c,c: cc cc n-i no 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue with length =0 

dstBuffer . length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.5.9.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for 




EnvelopeResponseHandl 




er 


C2 


11 



6.2.5.10 Method compare Value 

Test Area Reference: API_2_ERH_CPRVS_BSS 
6.2.5.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set , 
short compareLength) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

Compares the last found TLV element with a buffer: 
CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NuUPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAlLABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.10.3 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.CPRVS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


_ERH. 


.CPRVS. 


_BSS_ 


.l.java 


Load Script: 


API. 


.2. 


.ERH. 


.CPRVS. 


_BSS_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.CPRVS. 


.BSS. 


.l.ch 



6.2.5.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 










compareOffset ^ compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 

compareOffset = -1 

compareLength = 1 


ArrayindexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArrayindexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArrayindexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 

compareLength = —1 


ArrayindexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 
Select Text String TLV 






valueOffset > Text String Length 

valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 

compareOffset = 

compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES Is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








compareValue ( ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


appendTLV with TAG: OD and value: 04 00 01 
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... OF 








Seiect Text String TLV 








Initialise compareBuffer 








compareBuffer = 
04 00 01 ... OF 









Compare buffers 


Result is OOh 






valueOffset = 








compareOf f set = 








coinpareLencjth = 17 






13 


Initialise compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




\ 


iniiiaiiS6 cornpareDUTTer 

compareBuffer = 

DD DD DD Ul UZ 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 









Compare buffers 

valueOffset = 2 


Result is OOh 






compareOf f set = 3 
compareLength = 12 






16 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Successful call, compareValue with length =0 

compareBuf fer . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValueQ is 





6.2.5.10.4 Test Coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 16 


N3 


14, 17 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for 




Envelope ResponseHandl 




er 


02 


11 



6.2.5.1 1 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference: API_2_ERH_FACYB_BS 
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6.2.5.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



Normal execution 

CRRNl : looks for the first occurrence of a TLV element from the beginning of a TLV hst and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NuUPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAlLABLE. 

6.2.5.11.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.11.3 



API_2_ERH_FACYB_BS_1 .scr 
API_2_ERH_FACYB_BS_1 .java 
AP1_2_ERH_FACYB_BS_1 .Idr 
API_2_ERH_FACYB_BS_1 .ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








flndAndCopyValueQ with a null dstBuffer 


NuUPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








dstOffset ^ dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 

dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

dstBuffer.length = 15 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 
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dstOffset = 






6 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue ( ) 
tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


appendTLV with TAG: OD and value: 04 00 01 
... OF 








Successful call 

Tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCopyValueQ is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuff er . length = 20 
dstOffset = 2 


Result of findAndCopyValueQ is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 

OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 








append a 2"'' Text String TLV 









Successful call 

tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCopyValueQ is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndCoovValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 

1 iwwuii Iw %-» \y 1 1 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuffer . length = 16 
dstOffset = 


Result of findAndCopyValueQ is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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6.2.5.1 1 .4 Test Coverage 



CRR number 


Test esse number 


i\ 1 




N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ERH_FACYBBS_BSS 
6.2.5.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPoinrerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV hst and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NuUPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.12.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
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Test Script: API_2_ERH_FACYBBS_BSS_l.scr 

Test Applet: API_2_ERH_FACYBBS_BSS_1 .Java 

Load Script: API_2_ERH_FACYBBS_BSS_l.ldr 

Cleanup Script: API_2_ERH_FACYBBS_BSS_l.clr 



6.2.5.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendlLV with TAG: OD and length 16 






dstOffset ^ dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 

dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 

dstOffset - 
dSL^engrn -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLsriQ'th = 1 


Tooll^itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 

dstOffset - 
d s L ^ e n g L n 7 


ToolkitException.OUT_OF_TLV_ 
BOIINDARIFS i<; thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 






f IndAndCopyValue ( ) 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 




Call the getValueLength ( ) method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




12 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 


Result of findAndCopyValueQ is 
17 
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dst Offset - 








dsL-ijerigL.:"! 1 7 






1 3 


Comnare buffer 

hn-Ffor = 04 DO 01 OF 








inillallSc USlDUTTer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of flndAndCopyValueQ is 






tag = ODh, occurrence = 1 


15 






valueOffset = 2 








dstBuffer . length = 20 








asturrset — i 








dstLength = 12 






15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 

SS 

~j -J -j-j -j-j -j-j 


Result is OOh 




1 b 


Appenu a 1 exT oiring i lv 

tag = OD 

Durrer = UU 11 2z oo 44 55 (no speciric 
DCS byte) 








OUCC6SSTUI Call 




Result of findAndCopyValue() is 






tag = ODh, occurrence = 1 


17 






valueOffset = 








dstBuff er . length = 20 








dstOffset = 








dstLength = 17 






-1 -7 

1 / 


iff Ai* 

uompare Duner 

buffer = 04 00 01 ... OF 


riesuii IS uun 




\ O 


oUCCeSSTUi Call 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


Result of flndAndCopyValueQ is 
6 




19 


Compare buffer 

buffer 00 11 22 'i'i. 44 5 5 


Result is OOh 




£-.\J 


r^losir th^ Imnrll^i' snH snn^nHTI W lA/ith T A/^ ■ 
Lriccii iiic? iidiiuid cii lu dpj^diu 1 Willi ihwIb 

UU ana vaiUc. UH- UU u 1 ■>■ ur 








Successful call (with tag 8Dh) 

tag — oUn 


Result of findAndCopyValue () is 
17 






occurrence = 1 








valueOffset = 








dstBuffer . length = 17 








dstOffset = 








dstLength = 17 






21 


nnmnflfp hiiffpr 

1 luai c UU 1 Id 

hn-F-For = 04 00 01 OF 
ij Li J- -L t; J- — UU u -L ... ur 


RpQi lit iq nnh 






Appenu lag urn 

Durrer — UU Ul ... Ur 








Successful call (with tag 8Fh) 

tag — or n 


Result of findAndCopyValue () is 
16 






occurrence = 1 








valueOffset = 








dstBuff er . length = 16 








dstOffset = 








dstLength = 16 






23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Successful call, fIndAndCopyValue with 
length =0 

dstBuff er . length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValue () is 
16 
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nRR niimhpr 




N1 


1"? 15 17 19 




1 1 


N3 


12, 14, 16, 18, 24 


N4 


20, 21, 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ERH_FACRB_BS 
6.2.5.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte [ ] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.13.3 Test Suite files 

Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_FACRB_BS_l.scr 
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Test Applet: API_2_ERH_FACRB_BS_1 Java 

Load Script: API_2_ERH_FACRB_BS_l.ldr 
Cleanup Script: API_2_ERH_FACRB_BS_l.clr 



6.2.5.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 








findAndCompareValueO with a null dstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset ^ compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset ^ -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




A 

4 


compareuTTsei + lengin > 
compareBuffer.length 

compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


Array! ndexOutOf Bou ndsExceptio 
n is thrown 




6 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = 03h 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




8 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 


Result is OOh 






compareOffset = 






9 


Verify current TLV 

getValueLength ( ) 


Result is 1 7 




10 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 

AO fin ni fiTTi 
U3 UU Ul ... Ur 








Compare buffers with same parameters 


Result is +1 




12 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 05 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 


Result is OOh 






compareOffset = 2 






13 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 








02 03 04 05 06 








07 08 09 OA OB 








OC OD OE OF 55 








Compare buffers 


Result is OOh 
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compareOf f set = 2 






14 


Initialise compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Rp^ult 19 -1 




1 \j 


compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

compareOffset = 2 


Result is +1 




16 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 


Result is OOh 






tag = 8Dh 








compareBuf fer . length = 17 
compareOffset = 






17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag SFh) 


Result is OOh 






tag = SFh 








compareBuf fer . length = 16 








compareOffset = 







6.2.5.13.4 Test Coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11,15 


N6 


17, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 
Envelope response 
handler 



6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ERH_FACRBBS_BSS 
6.2.5.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 

buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRC 1 : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.14.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 



API_2_ERH_FACRBBS_BSS_1 .scr 



Test Applet: 



API_2_ERH_FACRBBS_BSS_1 .Java 



Load Script: 



API_2_ERH_FACRBBS_BSS_1 .Idr 



Cleanup Script: 



API_2_ERH_FACRBBS_BSS_l.ch 
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6.2.5.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValueQ with a null 
compareBuffer 


NullPointerException is tlirown 




2 


clear the handler and appendTLV with TAG: 
CD and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




o 


uuiiipdic^^i loci + uuiiipdrcLciiy III 

>compareBuffer.length 

compareBuffer . length = 5 
compareOffset = 3 
compareLength = 3 


A rro V/ 1 riHo v(^i it/~^f Drti i n/He C v/^^r*\tirt 

Mirdy iiiucxv^'uiv^iDouiiubtixocpiiu 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = —1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler and appendTLV with TAG 
and length of 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset ^ 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


Tooll<itException.BADJNPUT_P 
ARAMETER is thrown 




V2 


appendTLV with TAG 02 and length 02 








Select a TLV (tag 02h) 






f IndAndCompareValue ( ) 
tag = ODh 
occurrence = 2 


Tooll<itException. UNAVAILABLE 
_ELEMENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown. 




14 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 






Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 


Result is OOh 
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valueOffset = 








compareOf f set = 
compareLength = 17 






15 


Verify current TLV 

getValueLength ( ) 


Result is 1 7 




16 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




1 


llllllcllloC UUIIIUdlcDU 1 ICI 

compareBuffer = 

cc; [;[; c;c; riT no 

00 00 00 UI uz 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 


Result is OOh 






valueOffset = 2 








compareOf f set = 3 








compareLength = 12 






19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








IllllldlloC UUIIIUdlcDU 1 Ici 

compareBuffer = 
04 00 01 ... OF 








llilUMilUwUinpdrc ValUc^y 








tag = ODh, occurrence = 1 








valueOffset = 








compareOf f set = 








compareLength = 17 






C.C. 


Initialico /^/Mnnai'oRi iffor 

lllllldlldt? WUI 1 l|JCII CDU 1 Id 

compareBuffer = 
00 11 22 33 44 55 








1 II lUMI lu V.»UIII|ilcll C V diuc^^ 


Daci lit ic nnh 
ricoUii lb UUII 






tag = ODh, occurrence = 2 








valueOffset = 








compareOf f set = 
compareLength = 6 








InitifiliQA pninnsii'pRiiffpi' 

compareBuffer = 
00 11 22 33 44 66 








flndAndCompareVaiueQ 

tag = ODh, occurrence = 2 


Result is -1 






valueOffset = 








cC'mpareOf f set - 








c c mp a. r e ^ e n g L n 6 






24 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 


Result is OOh 






tag = 8Dh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 17 








compareOf f set ^ 








compareLength = 17 
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25 


Append tag OFh 

buffer = 00 01 ... OF 








lllllldlloc ipcll CDUl ICI 








compareBuf f er = 00 01 ... OF 








Successful call (with tag 8Fh) 


Result is OOh 






tag = 8Fh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 16 








compareOf f set = 








compareLength = 16 






26 


Successful call, findAndCompareValue with 
length =0 

CompareBuf fer . length = 16 
compareOf f set = 16 
compareLength = 


Result of findAndCompareValue 
is 00 





6.2.5.14.4 Test Coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18, 22, 21, 26 


N4 


16, 19, 23 


N5 


17, 19 


N6 


25, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.15 Method appendArray 

Test Area Reference: API_2_ERH_APDA_BSS 
6.2.5.15.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, short offset, short length) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: appends a buffer into the EditHandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRPl: if buffer is nuU, a java.lang.NuUPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 
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CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.15.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APDA_BSS_l.scr 
Test Applet: API_2_ERH_APDA_BSS_1 .Java 

Load Script: APl_2_ERH_APDA_BSS_l.ldr 
Cleanup Script: API_2_ERH_APDA_BSS_l.ch 



2.5.15.3 Test procedure 


Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 
TLV of length 1 






1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 5 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer.length = 5 
offset = -1 
length = 1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
orrset — U 
length = —1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 

length = 256 


Tooll<itException.HANDLER_OV 

PRPI OW ic thrniA/n 

dii L.wVV lo LIIIUWII 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 






findTLV 0x81 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 






Successful call 

buffer = FF FE ... F8 

offset = 
length = 8 






Call copyO method 








Compare handler 

compareBuf f er = FF FE ... F8 


Result is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 






Call copyO method 






Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result is OOh 




11 


Successful call 
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buffer = 11 22 ... 88 
offset = 2 
length = 4 






Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result is OOh 





6.2.5.15.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


N3 




P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.16 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_ERH_APTLBB 

6.2.5.16.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV hst (1-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.16.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_APTLBB_ 1 . scr 

Test Applet: API_2_ERH_APTLBB_l.java 

Load Script: API_2_ERH_APTLBB_l.ldr 

Cleanup Script: API_2_ERH_APTLBB_l.clr 
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6.2.5.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 253 








Handler Overflow: Call twice the 
appendTLVOmethod 


ToolkitException.HANDLER_OV 
ERFLOW is thrown by one of the 
two. 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 









Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 








tag = 84h 








value = OOh 








Call copyO method 








Compare handler 

compareBuf fer = 84 01 00 


Result is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare handler 


Result is OOh 






compareBuf fer = 84 01 00 01 01 FE 







Note : Test case 1 call twice appendTLV because the current 03.19 [7] is not clear enough on this point. So this test 
allows the two possible implementations. 

6.2.5.16.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.17 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: AP1_2_ERH_APTLBBB 
6.2.5.17.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the APT 

void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 
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Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a TooUdtException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.17.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APTLBBB_l.scr 
Test Applet: API_2_ERH_APTL BBB_1 .Java 

Load Script: API_2_ERH_APTL BBB_1 .Idr 

Cleanup Script: API_2_ERH_APTLBBB_l.cb- 

6.2.5.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArray with length of 253 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER_OV 
ERFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 






Clear the handler 








Successful call 








tag = 84h 
valuel = OOh 








value2 = Olh 








Call copyO method 








Compare handler 


Result is OOh 






compareBuf fer = 84 02 00 01 






4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result is OOh 





6.2.5.17.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 



6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API_2_ERH_APTLB_BSS 
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6.2.5.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte[] value, 
short valueoffset, 
short valuelength) 
throws java . lang . Nu 1 IP o inter Except ion, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value is null, a java.lang.NullPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 

6.2.5.18.2 Test suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.APTLB. 


_BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.APTLB. 


_BSS. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.APTLB. 


_BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.APTLB. 


_BSS. 


.l.clr 
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6.2.5.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset ^ value.length 

value. length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value.length = 5 

valueOffset = -1 

valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

value . length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 

V a J- UcW J- J- t> c L — U 

valueLength = 254 


ToolkitException.HANDLER_OV 
ERFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD INPUT P 
ARAMFTFR !<; thrnwn 




9 


clear the handler annend the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 









f^iiccp^^fiil call 








Lag — U ^ 








value = FF FE ... F8 








valueOffset = 









valueLength = 8 








Verify Current TLV: Call getVaiueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








value = FF FE ... F8 








va 1 ueOf f =^pt = 








valueLength = 8 








Call copyO method 








nomnarp hanrilpr 

CompareBuf f er = 04 08 FF FE ... F8 


Rp<:i lit Id nn 




11 


Successful call 

tag = 85h 

value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 









Call coDvO method 








Comparo handlor 


Rpei lit Is nn 






O UlLL^JcL J- CD U J. J. t: J- — U4 UO rr rili ... ro O ~J UD UZ. 








03 ... 07 






12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copvO method 








Compare handler 


Result is 00 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 








03 ... 07 01 04 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 
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value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 






Call copyO method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 





6.2.5.18.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




EnvelopeResponseHandl 




er 


C3 


8 



6.2.5.19 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_ERH_APTLBB_BSS 
6.2.5.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the APT 

void appendXLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set, 
short value21ength) 
throws java . lang .NullPointerExcept ion, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV hst (1 byte and a byte-array element). 
CRRISr2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value2 is null, a java.lang.NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAlLABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 
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6.2.5.19.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.19.3 



API_2_ERH_APTLBB_BSS_1 .scr 
API_2_ERH_APTLBB_BSS_1 .Java 
API_2_ERH_APTLBB_BSS_1 .Idr 
API_2_ERH_APTLBB_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset ^ value2.length 

value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkitException.HANDLER_OV 
ERFLOW is thrown 




8 


Bad parameter 

value2 . length = 256 
value20ffset = 
V axusz j-isny — zoo 


ToolkitException . BAD JNPUT_P 
ARAI\/IETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 






Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... FB 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copyO method 






Compare handler 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 
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Call copyO method 








Compare handler 


Result is 00 






compareBuf f er = 








04 09 05 FF FE ... F8 








85 07 55 02 03 ... 07 






12 


Successful call 

tag = 01 

■^/a 1 iif^l = 4 4h 

VCl-LL^vI^-^ — -LA. ... QO 

value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CornpsirsBuf f SIT = 

04 DQ DR FF FF F8 


Result is 00 






07 09 m 07 

U/ Ui. ... u/ 








01 05 44 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 








valuel = 00 








value2 = 01 ... 7F 








value20ffset = 








value2Length = 7Fh 








Call copyO method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 





6.2.5.19.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


02 


Does not apply for 




EnvelopeResponseHandl 




er 


03 


8 



6.2.5.20 Method clear 

Test Area Reference: API_2_ERH_CLER 



6.2.5.20.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear 

throws ToolkitException 

Normal execution 

CRRNl: Clears the TLV Ust of an EditHandler and resets the current TLV selected. 



Parameters error 
No requirements 

Context errors 

CRRCl: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 
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6.2.5.20.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.20.3 



API_2_ERH_CLER_1 .scr 
API_2_ERH_CLER_1 .Java 
API_2_ERH_CLER_1 .Idr 
API_2_ERH_CLER_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLength ( ) method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 





6.2.5.20.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 
EnvelopeResponseHandl 
er 



6.2.6 Class MEProfile 
6.2.6.1 Method check (byte index) 

Test Area Reference: API_2_MEP_CHECB 
6.2.6.1.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 
throws ToolkitException 

Normal execution 

CRRNl: The method checks a facility in the handset profile: returns true if supported and false if not. 
Parameters error 

CRRPl: The method shall throw ME_PROFILE_NOT_AVAILABLE ToolkitException if Terminal Profile data are 
not available 

Context errors 
No requirements 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.6.1.3 



API_2_MEP_CHECB_1 .scr 
API_2_MEP_CHECB_1 .Java 

API_2_MEP_CHECB_1 .Idr (the applet is loaded without INI after the reset (RST) 
API_2_MEP_CHECB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by unformatted SMS 
Index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

Index = 15 


false is returned by the method 





6.2.6.1.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


1 



6.2.6.2 Method check (byte [ ] mask, short offset, short length) 

Test Area Reference: API_2_MEP_CHEC_BSS 
6.2.6.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws java . lang . NullPointerExcept ion, 

java . lang . ArraylndexOutOf Bounds Except ion, 
ToolkitException 

Normal execution 

CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if they 
are all supported and false if not. 

CRRN2: The method returns true if the length to check is 0. 
Parameters error 

CRRPl: The method shall throw java. lang.NullPointerException if mask is null. 

CRRP2: The method shall throw java.lang.ArraylndexOutOfBoundsException if offset or length or both would 
cause access outside array bounds. 

CRRP3: The method shall throw ME_PROFILE_NOT_AVAILABLE ToolkitException if Terminal Profile data are 
not available. 
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Context errors 

No requirements 

6.2.6.2.2 Test suite files 

Specific triggering: 

UNFORMATTED_SMS_PP_UPD 
No Additional requirements for the GSM personalisation: 

Test Script: API_2_MEP_CHEC_BSS_l.scr 

Test Applet: API_2_MEP_CHEC_BSS_1 .Java 

Load Script: API_2_MEP_CHEC_BSS_1 .Idr (the applet is loaded without INI after the reset (RST)) 

Cleanup Script: APl_2_MEP_CHEC_BSS_l.clr 
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6.2.6.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 




No Terminal Profile is registered 


MC pRnFII F MOT AVAII 






Triggered by unformatted SMS 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ABLE ToolkitException is 
thrown 






Offset 


= 






Length 


= 16 






2 


NULL as parameter to check 

mask= NULL 


NullPointerException is 

11 II L'VVI 1 




o 


mask = 


Offset > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ArrayinaGxuuTUTtsounQstxc 
eption is thrown 






Offset 


= 17 




4 


mask = 


Offset < 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


Array IndexOutOfBoundsExc 
eption is thrown 






Offset 


= -1 




5 


mask = 


Length > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ArraylndexOutOfBoundsExc 
eption is thrown 






Offset 


= 






Length 


= 18 






c 
o 


Mask = 


Offset + length > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


A ri*Q\/l n/Hov^^i it^^f Drt 1 1 n^e C 
Mil ay iriUcAthJUlwlDUUliUoCXO 

eption is thrown 






Offset 


= 9 






Length 


= 9 






■7 

1 


mask = 
Offset 

Length 


length = 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
= 
= 


iruc IS reiurneu 




8 




Check all the Terminal Profile 


false is returned by the 






mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method because facility 1 5 is 






Offset 
Length 


= 

= 16 


not supported 




9 




Check a part of the Terminal Profile 


true is returned by the 






mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method: the 16 first facilities 






Offset 
Length 


= 15 
= 2 


except facility 15 have been 
successfully checked 




10 




Check a part of the Terminal Profile 


false is returned by the 






mask = 
Offset 
Length 


0x0080 
= 
= 2 


method only facility 15 is 
checked and not supported. 





6.2.6.2.4 Test Coverage 



CRR number 


Test case number 


N1 


8,9,10 


N2 


7 


PI 


2 


P2 


3,4,5,6 


P3 


1 



6.2.7 Class ProactiveHandler 
6.2.7.1 Method getTheHandler 

Test Area Reference: API_2_PAH_GTHD 
6.2.7.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandler ( ) 

throws ToolkitException 
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Normal execution 

CRRNl: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 



6.2.7.1.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.GTHD. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.GTHD. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.GTHD. 


.l.clr 



6.2.7.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandierQ 


The reference shall be a 
ProactiveHandler 




3 


getTheHandlerO 


The reference shall not be null 





6.2.7.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in 

Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 

insert here cross 
reference 



6.2.7.2 Method init 

Test Area Reference: API_2_PAH_INITBBB 
6.2.7.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 
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Normal execution 

CRRNl: The init() method initialises the next Proactive command in the ProactiveHandler, with Command details 
and Device Identities TLV. The source device is always the SIM Card (81h). The Comprehension Required flags 
are set. 

CRRN2: The Command number may take any value between Olh and FEh. 
CRRN3: The init() method clears the ProactiveHandler before initialising it. 
CRRN4: No TLV is selected after a call to the method. 
CRRN5: The handler is not sent to the mobile by the imt() method. 

Parameter errors 

No requirements 

Context errors 

No requirements 



6.2.7.2.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.INITBBB. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.INTTBBB. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.INTTBBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.INTTBBB. 


.l.clr 



6.2.7.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array 
(source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are 
identical 




2 


Verify the command number value 


01li-FEh 




3 


Call the init() method 

type = FFh 
qualifier ^ FEh 
destination = FDh 

Copy ProactiveHandler in a byte array 
(source) 
Compare the byte array 

reference = 

81h 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are 
identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getVaiueLengthQ method 


UNAVAILABLE_ELEI\/IENT 
ToolkitException is thrown by 
getValueLengthO 
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CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



6.2.7.3 Method initDisplayText 

Test Area Reference: API_2_PAH_INDTBB_BSS 
6.2.7.3.1 Conformance requirement 

The melhod with following header shall be compliant to its definition in the API. 

public void initDisplayText (byte qualifier, 

byte dcs, 
byte[] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using quahfier, 
dcs and buffer parameters. Comprehension required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The DISPLAY TEXT connmand is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shall throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, an ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small to put 
the requested data. 



6.2.7.3.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.INDTBB. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.INDTBB. 


-BSS. 


.l.java 


Load Script: 


APT 


_2_ 


_PAH 


JNDTBB. 


_BSS_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


PAH 


_INDTBB_ 


_BSS_ 


_l.ch 
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6.2.7.3.3 Test procedure 



Id 




t ^ A^d^ lull V/l 1 


APDIJ Fynpctatinn 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer = "Text" 
offset = -1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 

length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
orrser — j 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer Is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 

offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 

command 

qualifier - OOh 
dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer Is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 

length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Succesfull call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

iext — lextL- 


11 


Succesfull call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

butter — lziextuj4 
offset = 2 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Succesfull call, qualifier = 81h 
Send the command 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

C^U3.1 i fisiT = 81h 
dcs = 4 

Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 
Send the command 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 
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length = 5 






14 


Succesfull call, DCS=8 (UCS2) 
Send the command 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the InltDlsplayTextQ method with any 
value 

Then build and send a DISPLAY TEXT 
command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 

offset = 
length = 10 




DISPLAY TEXT Proactive 

\j\JI 1 II 1 IctI ILI 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length Is null 
Send the command 

qualifier = 
dcs = 4 

buffer = "" (not null buffer) 

offset = 
length - 




DISPLAY TEXT Proactive 

command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the InitDlsplayTextQ method 
Call the getVaiueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 

offset = 
length — /h^ti 




DISPLAY TEXT Proactive 

command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
1 enath = 940 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the InitDlsplayTextO method with a too 
long buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitDispiayTextO without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 
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ORR niimhoi' 
onn iiuiiiuci 


1 col i^doc iiuiiiuci 


N1 


8 9 10 11 12 1 14 




15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.4 Method initGetlnkey 

Test Area Reference: API_2_PAH_INGKBB_BSS 
6.2.7.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnkey (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, dcs 
and buffer parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INKEY conmiand is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shall throw NullPointerException if buffer is null. 

CRRPl: If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to put 
the requested data. 



6.2.7.4.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

AP1_2_PAH_1NGKBB_BSS_1 .scr 
API_2_PAH_1NGKBB_BSS_1 .java 
API_2_PAH_INGKBB_BSS_1 .Idr 
API 2 PAH INGKBB BSS l.clr 
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6.2.7.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2. 


offset > buffer. length 

buffer = "Text" 
offset = 5 


Array IndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
oirsei^ — J 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET IN KEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer is part of a buffer with 
the end part 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET IN KEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Succesfull call, buffer is part of a buffer with 
the first part 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




GETINKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 


11 


Succesfull call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

butter — lzlextuj4 
offset = 2 
length = 5 




GETINKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Succesfull call, qualifier = 81h 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




GET IN KEY Proactive 
command 

qualifier = 81h 
cics = 4 

Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




GET IN KEY Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 


14 


Succesfull call, DCS=8 (UCS2) 

qualifier = 




GET IN KEY Proactive 
command 
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dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkeyO method with any value 
Then build and send a GET INKEY command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 

offset = 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 




GET INKEY Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the initGetlnkeyO method 
Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




GET INKEY Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 

offset = 
length = 7Fh 




GET INKEY Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 




GET INKEY Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initGetlnkeyO method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitGetlnkeyO without sending the 
command 




No proactive command 
shall be sent expected 
status Is '9000' 



6.2.7.4.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 9, 10, 11, 12, 13, 14, 




15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 
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6.2.7.5 Method initGetlnput 

Test Area Reference: API_2_PAH_INGPBB_BSSSS 

6.2.7.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using quahfier, dcs, 
buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INPUT conmiand is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shaU throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to put 
the requested data. 

6.2.7.5.2 Test Suite files 

Test Script: API_2_PAH_INGPBB_BSSSS_1 .scr 

Test Applet: API_2_PAH_INGPBB_BSSSS_l.java 
Load Script: API_2_PAH_lNGPBB_BSSSS_l.ldr 
Cleanup Script: API_2_PAH_INGPBB_BSSSS_l.cb- 
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6.2.7.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




o 

d. 


offset > buffer.length 

buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer Is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 

mlnRespLength = OOh 
maxRespLength = FFh 


No exception is thrown 




veriTy ine coiniTianu nuiiiDei vaiue 


ooiTirTianQ numDer Detween ui n 
and -FEh 




8 


Send the command 




GET INPUT Proactive 

command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Mln Length = OOh 
Max Length = FFh 


9 


Succesfull call, buffer Is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 
mlnRespLength = lOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 
Min Length = lOh 
Max Length = FFh 


10 


Succesfull call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 
mlnRespLength = FFh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 
Min Length = FFh 
Max Length = FFh 


11 


Succesfull call, buffer Is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextD34" 

offset = 2 

length = 5 
mlnRespLength = OOh 
maxRespLength = OOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 
Min Length = OOh 
Max Length = OOh 


12 


Succesfull call, qualifier = 81h 

qualifier = 81h 
dcs = 4 




GET INPUT Proactive 
command 
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buffer = "TextE" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = lOh 




qualifier = 81h 
dcs = 4 

Text = "TextE" 
Min Length = OOh 
Max Length = lOh 


13 


Succesfull call, DCS=0 (7 bits) 

c^u^lifisi" = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 
minRespLength = lOh 
maxRespLength = lOh 




GET INPUT Proactive 

command 

qualifier = OOh 
dcs = 

Text = "TextF" 
Min Length = lOh 
Max Length = lOh 


14 


Succesfull call, DCS=8 (UCS2) 

gua.lif isiT = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 
Min Length = OOh 
Max Length = FFh 


15 


Call the InitGetlnputQ method with any value 
Then build and send a GET INPUT command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 
offset = 
length = 10 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 
Min Length = OOh 
Max Length = lOh 


16 


Successful call, text length Is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 

Min Length = OOh 

Max Length = lOh 


17 


Select a TLV In the ProactiveHandler 
Call the InitGetlnputQ method 
Call the getVaiueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 
Min Length = OOh 
Max Length = lOh 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 

length = 7Fh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 

command 

Text String TLV = 8D 81 
80 04 55 55... 
Min Length = OOh 
Max Length = lOh 


20 


Successful call, buffer length = 236 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 236 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

-Lt;A.L Ol L_LIjy ±1jV — 

8D 81 ED 04 55 55... 


21 


Call the InitGetinputO method with a too long 
buffer 


HANDLER_OVERFLOW 
ToolkitException is tiirown 





ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 143 ETSI TS 101 955 V7.4.1 (2002-03) 





qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 237 
minRespLength = OOh 
maxRespLength = lOh 






22 


Call the InltGetlnputQ without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 



6.2.7.5.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 9, 10, 11, 12, 13, 14, 




15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.6 Method send 

Test Area Reference: API_2_PAH_SEND 

6.2.7.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte sendO 

Normal execution 

CRRNl: The send() method send the current proactive command to the mobile. 

CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

CRRN3: The handler remains unchanged after a call to send() method until the use of initXX() or appendTLV(). 

CRRN4: There is no invocation of select() or deselect() method. 

CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 

Parameter errors 

No requirements 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Simple TLV is missing in 
Terminal Response. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV in Terminal Response. 

6.2.7.6.2 Test Suite files 

Test Script: API_2_PAH_SEND_l.scr 
Test Applet: API_2_PAH_SEND_1 .Java 
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Load Script: API_2_PAH_SEND_l.ldr 
Cleanup Script: API_2_PAH_SEND_l.clr 



6.2.7.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
H f Q — n dVi 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

RoQn1-|- TT'\7 — ni nn ( nmm» n H t\ci v -Fri TmciH 
rxcoU-LL ± J_i V — UO U -L UU ^ L-UllUlldlUJ. Ut: J. J_ U J. llLtiU 

successfully) 


Result of sendO is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer ^ ' Text ' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional Information on result 

with partial comprehension) 


Result of sendQ is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
rjrq = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01 , 
with Additional Information on result 

Result TLV = 03 02 01 55 (command 

C -L J- vJ 1. lUcU. WXLli jycii-LXclX L-UllLkJ J. fcrlifcrll o X Ull / 


Result of send() is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendO is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 

dcs = 04h 

buffer = "UUUUU..." 

length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 


1 


Build and send a 80h byte command 
(DISPLAY TEXT) 

qualifier = OOh 

dcs = 04h 

buffer = "UUUUU..." 

length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 80 
Text String TLV = 8D 75 
04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 

TTi n/i c,c cc 
r 1 U 41 DO DO... 


12 


Verify that the Proactive Handler Is not 
modified after a send() 
Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 
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Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 
Verify there is no invocation of seiectQ or 
deselectQ method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2na Result TLV = UJ UJ UJ J4 oo 


Result of sendO is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkltException.UNAVAILABLE 
_ELEMENT is thrown by sendO 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result 
byte in the Simple TLV 

Result TLV = 03 00 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown by 
sendQ 





6.2.7.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 10, 11, 12, 




13, 14 


N2 


2, 4, 6, 8,14 


N3 


12 


N4 


13 


N5 


To be checked in 




Framework tests and 




insert here cross 




reference 


CI 


15 


C2 


16 



6.2.7.7 Method getLength 

Test Area Reference API_2_PAH_GLEN 

6.2.7.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl: returns the length in bytes of the TLV hst. 

Parameter errors 

No requirements 

Context errors 

CRRC 1 : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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6.2.7.7.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.GLEN. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.GLEN. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.GLEN. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.GLEN. 


.l.clr 



6.2.7.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO is 




2 


Call the InltQ method 

getLength ( ) 


Result of getLengthQ is 9 




3 


Call the InltDlsplayTextO method, with buffer 
length = 240 

getLength ( ) 


Result of getLengthQ is 253 




4 


Build a 7Fh Proactive Handler 

getLength ( ) 


Result of getLengthQ is 7Fh 




5 


Build a 80h Proactive Handler 

getLength ( ) 


Result of getLengthQ is 80h 





6.2.7.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4,5 


C1 


Does not apply for 
Proactive Handler 



6.2.7.8 Method copy 

Test Area Reference API_2_PAH_COPY_BSS 
6.2.7.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 
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CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUNDARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.8.2 Test Suite files 



Test Script: 


APT 


_2_ 


_PAH_ 


COPY, 


BSS_ 


l.scr 


Test Applet: 


APT 


_2_ 


_PAH_ 


_ COPY. 


_BSS. 


_l.java 


Load Script: 


APT 


_2_ 


_PAH_ 


_ COPY. 


_BSS. 


_l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


. COPY. 


_BSS. 


_l.ck 



6.2.7.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the init() method 






DstOffset > dstButfer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer . length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


DstLength > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 

dstLength = 10 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 1 2 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 

dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 
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CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




ProactiveHandler 



6.2.7.9 Method findTLV 

Test Area Reference API_2_PAH_FINDBB 
6.2.7.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV hst (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.9.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.FINDBB. 


.l.java 


Load Script: 


APT 


_2_ 


_PAH 


_FINDBB_ 


_l.ldr 


Cleanup Script: 


API. 


_2_ 


_PAH 


_F1NDBB_ 


_l.ch 
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6.2.7.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








Invalid input parameter 

Occurrence = 


ToolkitException.BAD_INPUT_P 
ARAMETER is thrown 




2 


Call the initQ method 








Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 

Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag - Olh 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException .UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 

Occurrence = 2 


RoQI lit IQ 

TLV_FOUND_CR_NOT_SET 




1 1 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 





6.2.7.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


CI 


Does not apply for 




Proactive Handler 



6.2.7.10 Method getValueLength 

Test Area Reference API_2_PAH_GVLE 
6.2.7.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 
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Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException H ANDLER_NOT_AV AIL AB LE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.10.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.GVLE. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.GVLE. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.GVLE. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.GVLE. 


.l.clr 



6.2.7.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitQ method 








getValueLength ( ) 


ToolkitException.UNAVAILABLE 
ELEMENT is tlirown 




2 


Call the appendTLVQ method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 




3 


Call the InitDisplayTextQ method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Call the InitDisplayTextO method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fli 




5 


Call the InitDisplayTextQ method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 80li 




6 


Call the InitDisplayTextO method 

length ^ FOh (maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is F1 h 
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CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 
Proactive Handler 


C2 


1 



6.2.7.11 Method getValueByte 

Test Area Reference API_2_PAH_GVBYS 

6.2.7.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.11.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_GVB YS_1 .scr 
API_2_PAH_GVB YS_1 .Java 
API_2_PAH_GVB YS_1 .Idr 
API 2 PAH GVBYS l.ch 
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6.2.7.1 1 .3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitQ method 

type = FFh 
qualifier = FEh 
destination = FDh 








getvaiueDyie(U; 


T r^r^\\f\^^\mnnV,r^r^ 1 IMA\/AII ADI C 

1 OOlKltbXCeptlOn.UNAVAILADLb 

ELEMENT is thrown 




iL 


oearcn ilv um (uommana ueiaiis ilv) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




c; 


II lllUI9|JICiy 1 CAl^y 

buffer = 00 01 ... 7D 
length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


initDisplayTextO 

buffer = 00 01 ... 7D 7E 
length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 




8 


initDisplayTextO 

buffer = 00 01 ... EF 
length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





6.2.7.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




Proactive Handler 


C2 


1 



6.2.7.12 Method copyValue 

Test Area Reference API_2_PAH_CPYVS_BSS 
6.2.7.12.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NuUPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of TooUdtException shall be 
thrown. The reason code shall be TooUdtException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
TooUdtException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.12.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.CPYVS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.CPYVS. 


.BSS. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.CPYVS. 


.BSS. 


.l.ldr 


Cleanup Script: 


APL 


_2_ 


_PAH 


_CPYVS_ 


_BSS_ 


.l.ch- 



6.2.7.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InltDlsplayTextQ with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 
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dstBuff er . length = 15 








^ 4- 4^ 4^ ^ ^4- n 

ustuiisei: — u 








dstLength = 






8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
dstBuff er . length = 15 

^ ^ 4- 4^ 4^ ^ ^4- n 

dstuiiset — u 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
valueOffset = 
dstBuff er . length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




\ U 


[oeieci lexi siring ilvj 

length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


1 ooiKitbxception.uu l_Ur_l LV_ 

ROI IMRAQIPQ ie thrniA/n 

tDVJUiNL/Mriico IS inrown 




11 


Initialise the handler 








copyValueO 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






'■ — ^Zn'- i T Z7\ 

initLJispiayTextO 

dcs = 4 

buffer = 00 01 ... OF 
Select Text String TLV 








Successful call 


RpQi lit nf ponvVali ipH i<5 17 






valueOffset = 








dstBuff er . length = 17 








dstOffset = 








dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValueO is 1 5 






valueOffset = 2 








dstBuffer. length = 20 








(.lo L k.' J- J- o c L — O 








dstLength = 12 






15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.7.12.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4,5,6 


P3 


7, 8, 9, 10 


CI 


Does not apply for 




Proactive Handler 


C2 


11 



6.2.7.13 Method compareValue 

Test Area Reference API_2_PAH_CPRVS_BSS 
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6.2.7.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 



public byte compareValue (short valueOffset, 



byte[] compareBuf f er, 
short compareOf f set, 
short compareLength) 



throws java . lang . NullPointerExcept ion. 



java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 



Normal execution 

Compares the last found TLV element with a buffer: 
CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.13.2 



Test Suite files 



Test Script: 



API_2_PAH_CPRVS_BSS_l.scr 



Test Applet: 



API_2_PAH_CPRVS_BSS_1 .java 



Load Script: 



API_2_PAH_CPRVS_BSS_1 .Idr 



Cleanup Script: 



API_2_PAH_CPRVS_BSS_1 .clr 
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6.2.7.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




d. 


iniTuispiay 1 6X1^) wiin lengin = lo 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 

O UlLLkJcL J- fc! J-itJl ly L 11 — -L 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextO with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 

L- UllitJci J- C J-iCl ly 1— 1 i — 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

valueOffset ^ 2 
compareBuffer.length = 15 
compareOffset ^ 
compareLength = 5 


ToolkitException.OUT_OF_TLV_ 
BOIINDARIFS i<; thrown 




11 


Initialise the handler 








compareValueO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


InitDisplayTextO 

dcs = 4 

V-.iTF-Fcir- — on 01 
wuJ-J-ci. — uu U-L ... ur 

Select Text String TLV 














Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOffset = 
compareLength = 17 


Result is OOh 




13 


Initialise compareBuffer 
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compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 

OE 10 








Compare buffers witli same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnare buffers with same narameters 

III I^Cll ^/U 1 l^^l w TV 1 & I 1 001 1 1 W l^dl Cll 1 l^^&wl w 


Ppci lit ic 




15 


initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 

03 04 05 06 07 
wo U.J u/ 

08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 

r~imT^a T~oT .on rT"l" Vi = 1 '9 


Result is OOh 




1 6 


Initialise coirmareRuffer 

1 1 1 1 iidi i^v^^ w^#i 1 1 i^m ^^L'u 1 1 wi 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 






Comnare buffers with samp naraineters 

III I^Cll ^/U 1 1^71 w TV 1 & I 1 wCMI 1 1 V I^CMI %Mm 1 l^^&wl w 


Ppci lit ic -1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.7.13.4 Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Handler 


C2 


11 



6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference API_2_PAH_FACYB_BS 
6.2.7.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag. 
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byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV Ust and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.14.2 Test Suite files 



Test Script: 


API. 


.2. 


.PAH. 


.FACYB. 


_BS. 


.l.scr 


Test Applet: 


API. 


.2. 


.PAH. 


.FACYB. 


_BS. 


.l.java 


Load Script: 


API. 


.2. 


.PAH. 


.FACYB. 


_BS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.FACYB. 


.BS. 


.l.cb- 



6.2.7.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDlsplayTextQ with length = 15 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


Array 1 ndexOutOf Bou ndsExceptio 
n is tiirown 




3 


dstOffset < 

dstBuffer.length = 20 

dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tiirown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is tiirown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is tiirown 




6 


InitDlsplayTextQ 








Select a TLV (tag 02h) 








fIndAndCopyValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEMENT is tiirown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is tiirown. 
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7 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

Tag = ODh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer. length = 20 
d=5tnff«5et = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

buffer = 

ss 04 on ni 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




1 1 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

tag = ODh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndcopyValueO is 

-1 7 
1 / 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuff er . length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag SFh) 

tag = SFh 

dstBuff er . length = 16 
dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.14.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Handler 
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6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PAH_FACYBBS_BSS 

6.2.7.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl : looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of TooUdtException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.15.2 Test Suite files 



Test Script: 


API. 


.2. 


.PAH. 


.FACYBBS. 


_BSS_ 


_Lscr 


Test Applet: 


API. 


.2. 


.PAH. 


.FACYBBS. 


_BSS_ 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.FACYBBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.FACYBBS. 


.BSS. 


.l.clr 
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6.2.7.15.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


InitDlsplayTextO with length = 15 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 

dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




c: 
\j 


d^tOff^pt 4. riQtLpnnth ^ri^tBiiffpr Ipnnth 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Arrav/lnHovOi itOfRni inHcPvppntin 

rAI 1 dy 1 1 JUCAWULWI CJtJUl IUoC^Al^C[JLI<J 

n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7_ 


initDisplayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll^itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 

dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




11 


InitDlsplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 




— 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
tLtMtiN 1 IS mrown. 




12 

- - 


InitDlsplayTextO 

dcs = 4 

UUJ-J.(dr — UU U J- ... Ur 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 

dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 
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dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 

ni no 

55 55 55 01 Oz 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOli 




16 


Append a Text String TLV 

tag = OD 

Durrer — UU 11 zz oo 414 dd (no speciric 
DCS byte) 








Successful call 

j~ :^ n = riFlVi 1^ 1^ 1^ n T" T* o n 1^ o = 1 

L-Ciy — KJULlf U I.-. I.-. U J- J- tJ 1 1 1.-, t; — -L 

valueOffset = 
dstBuff er . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 

1 / 




17 


Compare buffer 

hiTF-F(=»T = 04 DO ni OF 


Result is OOh 




18 


Successful call 

valueOffset = 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueO is 

c 
D 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


InltDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 
occurrence — 1 
valueOffset = 
dstBuff er . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

Durrer — uu Ul ... Ul 








Successful call (with tag SFh) 

tag = SFh 
occurrence = 1 
valueOffset = 
dstBuffer . length = 16 

dstOffset = 
dstLength = 16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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1 col WClOC 1 lUI 1 lUCI 


IM 1 


-|0 HC "17 -|Q 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20, 21, 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




ProactiveHandler 



6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PAH_FACRB_BS 

6.2.7.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.16.2 Test Suite files 

Test Script: API_2_PAH_FACRB_BS_l.scr 
Test Applet: API_2_PAH_FACRB_BS_1 .java 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 164 ETSI TS 101 955 V7.4.1 (2002-03) 

Load Script: API_2_PAH_FACRB_BS_l.ldr 
Cleanup Script: API_2_PAH_FACRB_BS_l.clr 



6.2.7.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








mmnnrpOff ^pt rntnnArpRiiffpr iprinth 

tag = ODh 

compareBuf fer . length = 20 
compareOf f set = 21 


ArrawlnrlPvOi itOfRni innQpYPPntin 

n i<5 thrnwn 

II lO Llll WW 1 1 




3 


compareOffset < 

compareBuf fer . length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuf fer . length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

compareBuffer . length 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




_§__ 


InitDisplayTextQ 








Select a TLV (tag 02h) 









findAndCompareValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 







Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




7 


InitDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 1 7 




9 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 






- 


Compare buffers with same parameters 


Result is -1 




10 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 
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Compare buffers 


Result is OOh 




13 


initialise compareBuffer 

r"" 1^ m r~i T" Ci Ft 1 1 "F "F Ci T" = 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

i"" r~imT^;3 T*"CsO "F "F Q cs"l" = 7 
L. LJlLi^Cl J- t; W -L X o t; L. — i. 


Result is -1 




14 


Initialise compareBuffer 

r~iinT^;3 T*"oRn "F "Fo T*" = 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 









Compare buffers 

compareOf f set = 2 


Result is +1 




15 


InltDlspiayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 

compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = BFh 

compareBuf fer . length = 16 
compareOf f set = 


Result is OOh 




17 


Initialise compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is +1 





6.2.7.16.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 




Proactive Handler 



6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PAH_FACRBBS_BSS 
6.2.7.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.17.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.FACRBBS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.FACRBBS. 


.BSS. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.FACRBBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.FACRBBS. 


.BSS. 


.l.clr 
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6.2.7.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








flndAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


initDisplayTextQ with length = 15 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 

compareOffset - 
cC'mpa.re^engLri 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 

> compareBuffer . length 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextQ with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OLIT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 

compareOffset = 

compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + comoareLenoth > Text Strlna 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


TnolkitExrpntion OUT OF TLV 
BOUNDARIES is thrown ~ ~ 




11 


Invalid parameter 

occurrence = 


ToolkitException.BADJNPUT_P 
ARAMETER is thrown 




12 


InitDisplayTextQ 








Select a TLV (tag 02h) 









findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
PI FMFNT id thrnwn 






Call the getValueLengthQ method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




13 


initDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 














Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 


Result is OOh 
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tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 






14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result Is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








ComDarp buffpr^ with samp naramptprs 

111 i^Qi w i^u 1 1 V 1 w vv 1 & I i wm 1 1 V um cii 1 1 w iwi w 


Rpci lit Iq -1-1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 Ofi 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 

compareOf f set = 3 

r^r^TTi"r^^"K^^^T,^^inrT"l~ln = "1 V 
1 L L kJ cii-crJ-icriiyUii — 


Result is OOh 




1 8 


Initialise comDarpBuffpr 

1 1 1 1 IIQI 1 w^/i 1 1 w U 1 1 wl 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








ComDare buffers with same narametprs 

III w ^/u 1 1^71 w vv 1 & i 1 wQi 1 1 w cii 1 1 w & vi w 


RpQi lit -1 




19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

L. UlllkJcl J- CD LI J- J- C J- — 

04 00 01 ... OF 









flndAndCompareVaiueQ 

L, ciy — KJULif \j u j_ j_ c; 1 1 o t; — -l 

valueOffset = 

compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

W 1 L L kJ Cl-LvI^lJLl-L-Lcr-L — 

00 11 22 33 44 55 








flndAndCompareVaiueQ 

"1" 3 = OPlVi r^r- ^^^^ Y" fdr\ = 

UCiy — \J U 11 f ^k^k^Lli-i-dlOti — ^ 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








flndAndCompareVaiueQ 

tag = ODh, occurrence = 2 
valueOffset ^ 
compareOf f set = 


Result is -1 
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compareLength = 6 






23 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








iniiiaiisc coinpareDUTTsr 

CompareBuf fer = 04 00 01 ... OF 






. 


OUCC6SSTUI Call ^Wlln lag oUn^ 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 


riesuii IS uun 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initial AAi'm^Ai'AD i iff ai* 

iniiiaiiss coiTipareDUTTer 

compareBuf fer = 00 01 ... OF 








ouccessTui Call ^wiin lag orn) 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 16 
compareOf f set = 
compareLength = 16 


riesuit IS uun 




25 


Initialise compareBuffer 

compareBuf fer =0099 02 ... OF 








flndAndCompareVaiueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





6.2.7.17.4 Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20, 21 


N4 


15, 18, 22 


N5 


16, 19 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




Proactive Handler 



6.2.7.18 Method appendArray 



Test Area Reference: API_2_PAH_APDA 
6.2.7.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, 
short offset, 
short length) 
throws java . lang .NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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Normal execution 

CRRNl: appends a buffer into the Edithandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRPl: if buffer is nuU, a java.lang.NuUPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a TooUdtException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a TooUdtException is thrown with reason code 
HANDLER_NOT_AVAlLABLE 



6.2.7.18.2 Test suite files 



Test Script: 


API. 


.2. 


PAH. 


.APDA_ 


.l.scr 


Test Applet: 


API. 


.2. 


_PAH. 


_APDA_ 


_l.java 


Load Script: 


API. 


.2. 


_PAH. 


_APDA_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.APDA_ 


.l.ch 



6.2.7.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
offset = 
length = -1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 
length = 256 


ToolkitException.HANDLER_OV 
ERFLOW is thrown 




8 


Initialise handler 








Select Command Details TLV 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 
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buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf f er = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO Is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copvO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




12 


Clear the handler 








Successful call 

buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 





6.2.7.18.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


02 


Does not apply for 




ProactiveHandler 



6.2.7.19 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_PAH_APTLBB 
6.2.7.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV hst (1-byte element). 
CRRN2: A successful append does not modify the TLV selected. 
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Parameters error 

No requirements 

Context errors 

CRRCl: if the EditHandler buffer is too small to append the requested data, a TooUdtException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 



6.2.7.19.2 Test suite files 



Test Script: 


APT 


_2_ 


_PAH 


_APTLBB_ 


_l.scr 


Test Applet: 


APT 


.2. 


PAH. 


.APTLBB. 


.l.java 


Load Script: 


APT 


.2. 


PAH. 


.APTLBB. 


.Tldr 


Cleanup Script: 


APT 


.2. 


PAH. 


.APTLBB. 


.Tclr 



6.2.7.19.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call append ArrayO 

length = 251 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER_OV 
ERFLOW Is thrown 




2 


Initialise handier 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result Is 03h 




3 


Clear the handier 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCo 
mpareO Is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCo 
mpareO Is OOh 




5 


Clear the handier 








Call append ArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 








Successful call 

tag = 84h 
value = OOh 








Call getLengthQ method 


result = 253 






Call copyO method 








Compare the array 

compareBuf fer = 00 81 F7 03 04 ... F9 84 01 

00 


Result of 

javacard.framework.Utll.arrayCo 
mpareO is OOh 
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CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for 




Proactive Handler 



6.2.7.20 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_PAH_APTLBBB 

6.2.7.20.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

No requirements 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.7.20.2 Test suite files 



Test Script: 


API. 


.2. 


PAH. 


.APTLBBB. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.APTLBBB. 


.l.java 


Load Script: 


API. 


.2. 


PAH. 


.APTLBBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.APTLBBB. 


.l.ch 
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6.2.7.20.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitDisplayTextO 

length = 250 








Handler Overflowi Call the appendTLVQ 
method 


1 OOIKItbXCeptlOn.HANULbri_Uv 
ERFLOW is thrown 




2 


Initialise handler 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copvO method 









Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCo 
mpare() is OOh 




5 


Clear the handler 








Call append ArrayO 

length =24 9 

buffer = 00 81 F6 03 04 ... F8 






- - 


Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 





6.2.7.20.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for 




Proactive Handler 



6.2.7.21 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API_2_PAH_APTLB_BSS 
6.2.7.21.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag. 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



175 



ETSI TS 101 955 V7.4.1 (2002-03) 



byte [ ] value, 
short valueoffset, 
short valuelength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 



Normal execution 

CRRNl: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value is null, a java.lang.NullPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER 



6.2.7.21.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.21.3 



Test suite files 

API_2_PAH_APTLB_BSS_l.scr 
API_2_PAH_APTLB_BSS_l.java 
API_2_PAH_APTLB_BSS_1 .Idr 
API_2_PAH_APTLB_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueoffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


valueOffset < 

value . length = 5 
valueoffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


valueLength > value.length 

value.length = 5 
valueoffset = 
valueLength = 6 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

value.length = 5 
valueoffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 
valueoffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueoffset = 


ToolkitException. HANDLER_OV 
ERFLOW is thrown 
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valueLength = 254 






8 


Bad parameter 


Toolkit Exception . BAD_I N PUT_P 






value. length = 256 


ARAMETER is thrown 






valueOffset = 








valueLength = 256 






9 


Initialise handler 








Select Command Details TLV 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Verify Current TLV: Call getvaiueLength o 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Call copyO method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 


javacard.framework.Util.arrayCo 








mpareO is OOh 




11 


Successful call 








tag = 85h 








value = 00 01 ... 07 








valueOffset = 2 








valueLength = 6 








Call copyO method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 


javacard.framework.Util.arrayCo 






03 ... 07 


mpareO is OOh 




12 


Successful call 








tag = 01 








value = 11 22 ... 88 








valueOffset = 2 








valueLength = 4 









Call copyO method 








Compare the arrays 


Result of 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 


javacard.framework.Util.arrayCo 






03 ... 07 01 04 33 44 55 66 


mpareO is OOh 




13 


Clear the handler 








Successful call 








tag = 04 








value = 00 01 ... 7F 








valueOffset = 








valueLength = BOh 









Call copyO method 








Compare the arrays 


Result of 






compareBuf fer = 04 81 80 00 01...7F 


javacard.framework.Util.arrayCo 








mpareO is OOh 




14 


Clear the handler 








Successful call 








tag = 04 








value = 00 01 ... F9 








valueOffset = 








valueLength = 250 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 


Result of 






compareBuf fer - 04 81 FA 00 01. ..F9 


javacard.framework.Util.arrayCo 








mpareO is OOh 
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CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 




Proactive Handler 


C3 


8 



6.2.7.22 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_PAH_APTLBB_BSS 
6.2.7.22.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte[] value2, 
short value2of f set , 
short value21ength) 
throws java . lang . NullPointerException, 

java . lang .Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV hst (1 byte and a byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value2 is null, a java.lang. NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, ajava.lang.ArraylndexOutOfBoundsExceptionis thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a TooUdtException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD E^JPUT PARAMETER 



6.2.7.22.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test suite files 

API_2_PAH_APTLBB_BSS_1 .scr 
API_2_PAH_APTLBB_BSS_1 .java 
API_2_PAH_APTLBB_BSS_1 .Idr 
API 2 PAH APTLBB BSS l.clr 
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6.2.7.22.3 Test procedure 



Id 


DescriDtion 


API Exoectation 


APDU Exoectatlon 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

value2 . length = 5 
valuezOffset = -1 
value2 Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 

value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20f f set = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = —1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler ovorflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkitExrPDtion HANDLER OV 
ERFLOW is thrown 




Q 
o 


value2Length = 256 


TnnlkitFYrpntinn RAR INPI IT P 
ArlAIVIt 1 trl IS InrOWH 




9 


Initialise handler 








Select Command Details TLV 








Successful call 








tag = 04 








VclXUC-L — UO 








va.-LUS^ — r r r 111 ... r 








1 np2nf f qpt = n 








value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








valuel = 05 








value2 = FF FE ... F8 








value20ffset = 








value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

compareBuf f er = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare the arrays 

CompareBuf fer = 

04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 
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3 5 7 5 5 02 3 ... 7 

01 o 4 4 5 5 4 4 o o '0 D 






13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




1 A 


r^lpflr thp hfinrilpr 








f^llCCP^^flll Cflll 

tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copvO method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 





6.2.7.22.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2, 3, 4,5,6 


CI 


7 


02 


Does not apply for 




Proactive Handler 


03 


8 



6.2.7.23 Method clear 

Test Area Reference: API_2_PAH_CLER 



6.2.7.23.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the APT 

void clear () 

throws ToolkitException EditHandler 

Normal execution 

CRRNl: Clears the TLV hst of an EditHandler 
CRRN2: Resets the current TLV selected. 



Parameters error 
No requirements 
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Context errors 

CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 



6.2.7.23.2 Test suite files 



Test Script: 


API. 


.2. 


PAH. 


.CLER. 


.l.scr 


Test Applet: 


API. 


.2. 


_PAH. 


_CLER_ 


.l.java 


Load Script: 


API. 


.2. 


_PAH. 


_CLER_ 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.CLER_ 


.l.ck 



6.2.7.23.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 





6.2.7.23.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


C1 


Does not apply for 
Proactive Handler 



6.2.8 Class ProactiveResponseHandler 
6.2.8.1 Method copyAdditionallnformation 



Test Area Reference: API_2_PRH_CPAI_BSS 
6.2.8.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation (byte [ ] dstBuffer, 

short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: The copyAdditionalInformation() method shall copy a part of the additional information field from Result 
TLV element in dstBuffer, using dstOffset and dstLength. 

CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

CRRN3: The method returns (dstOffset + dstLength). 
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CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 
CRRN5: The method shall copy from the first Result TLV. 

Parameter errors 

CRRPl: A NullPointerException shall be thrown if dstBuffer is null. 

CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 

Context errors 

CRRCl: A ToolldtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUNDARIES shall be thrown if dstLength is greater than the value 
field of the available TLV. 



6.2.8.1.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.1.3 



Test Suite files 

API_2_PRH_CPAI_BSS_1 .scr 
API_2_PRH_CPAI_BSS _l.java 
API_2_PRH_CPAI_BSS _l.ldr 
AP1_2_PRH_CPA1_BSS _l.ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 
dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 








Result TLV = 03 OC 01 01 23 45 67 89 AB 

CD EF 01 23 45 








NULL as parameter to dstBuffer 

dstBuffer = NULL 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer. length = 10 
dstOffset = 11 
dstLength = 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 10 
dstOffset = -1 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 10 

dstOffset = 6 
dstLength ^ -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 








Result TLV = 03 06 01 01 23 45 67 89 
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Successfull call, dstBuffer Is the whole buffer 

dstBuffer . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06li. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 








Result TLV = 03 07 01 AB CD EF FE DC BA 








Successful! call, dstBuffer is part of a buffer 

dstBuff er . length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




11 


Compare dstBuffer using arrayCompareQ 

src = {AB, CD, EF, FE, DC} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO Is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




1 ciininai ncspunss wiin i aOuiiionai oyiss 








Result TLV = 03 08 01 FE DC BA 98 76 54 

32 








Successfull call, dstBuffer is part of a buffer 

dstBuff er . length = 7 

dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




13 


Compare dstBuffer using arrayCompareQ 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




1 erininai riesponse wiin o auuiiionai oyiss 








Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successfull call, dstBuffer Is the whole buffer 

dstBuff er . length = 9 

dstOffset = 2 
dstLength — 5 


result of 

copyAdditionallnformationO is 
07h. 




15 


Compare dstBuffer using arrayCompareQ 

src = {00, 11, 22, 33, 44} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 








Result TLV = 03 81 F3 01 00 01 02 03... 








Successfull call to the method 

dstBuff er . length = F2h 
dstOffset = 
dstLength = F2h 


result of 

copyAdditionallnformationO Is 
F2h. 




17 


Compare dstBuffer using arrayCompareQ 


result of arrayCompareO is OOh. 
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src = {00, 01, 02, 03, 04...} 

srcOffset = 00 
dest = dstBuffer 

length = F2h 






18 


Call the getValueLengthO method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal ResDonse with 5 additional bvtes 








Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


OUT OF TLV BOUNDARIES 
ToolkitExcGption is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 








Result TLV = 03 06 01 00 11 22 33 44 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionailnformationQ method 

dstBuff er . length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompareQ 

src = { 


result of arrayCompareO is OOli 






OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 

OAh OBh nrh nnh OFh 

OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 






21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 








1st Result TLV = 03 06 01 01 23 45 67 89 

2nd Result TLV = 03 01 00 








Successfull call to 
copyAdditionailnformationQ 

dstBuff er . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
0511. 




22 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getValueLengthO method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE 
_ELEI^ENT is thrown by send() 






ProactiveResponseHandler, getThelHandler 
call copyAdditionailnformationQ 


Tooll<itException. UNAVAILABLE 
ELEI\/IENT is thrown 
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nRR niimhpr 




N1 


8 11 13 15 17 20 22 


N2 


20 


N3 


7, 10, 12, 14, 16, 21 


N4 


9, 18, 23 


N5 


21 , 22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


24 


C2 


19 



6.2.8.2 Method copyTextString 

Test Area Reference: API_2_PRH_CPTS_BS 
6.2.8.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws java . lang . NullPointerExcept ion, 

java . lang . ArraylndexOutOf Bounds Except ion, 
ToolkitException 

Normal execution 

CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, using 
dstBuffer and dstOffset. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

CRRN3: The method returns (dstOffset + length of copied value). 

Parameter errors 

CRRPl: A NulIPointerException shall be thrown if dstBuffer is null. 

CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the TextString 
to be copied, without the Data Coding Scheme included), as specified for the returned value, would cause access 
outside array bounds. 

Context errors 

CRRCl: A ToolldtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 



6.2.8.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_CPTS_BS_1 .scr 
AP1_2_PRH_CPTS_BS_1 .java 
AP1_2_PRH_CPTS_BS_1 .Idr 
API 2 PRH CPTS BS l.ch 
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6.2.8.2.3 Test procedure 



IH 
lu 


uescripiion 


Mri cxpeciaiion 


MrUU CApcClallun 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 








Text String TLV = OD 02 04 41 








ProactlveResponseHandier.getTheHandierO ; 

call the copyTextStringO method with a null 
dstBuffer 


NullPointerException is thrown 






dstBuffer = null 
dstOffset = 






2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 








Text String TLV = OD 04 04 "ABC" 









dstOffset + text length > dstBuffer.length 

dstBuff er . length = 04h 
dstOffset = 02h 


ArraylndexOutOfBoundsException 
is thrown 




O 


OSIUTTSei < u 

dstBuffer.length = 04h 

dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 





Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerO ; 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 







DUIIU allQ ScllQ a dC 1 IHrU 1 CUIIIIIIaniJ 




r^PT IMPI IT Drr»Qf^ti\/£i 

1 iiNru 1 r roaciive 
command 
Proactive 




Terminal Response with a null Text String tlv 








Text String TLV = OD 00 









Initialise dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStringO method 


Result of copyTextStringO is 02h 






dstBuffer.length = 04h 
dstOffset = 02h 






c 

D 


r^/imnaro HetRiiffor iieinfi afrauOmrinfiroA 
oui 1 i|jcii c uoiDU 1 Id uaiiiy di 1 ciyouiii|Jcii c^y 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


ricoUii ui ctiiciyouiii|jciic^^ lo uuii 




■7 

1 


DUiiu ano seno a uci inkui commana 




^CT IMDI IT Df/^o/^titfA 

ot 1 iNru 1 rroactive 

command 

Proactive 




Terminal Response with text length = Olh 








Text String TLV = OD 02 04 41 








initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 


Result of copyTextStringO is 01 h 






dstBuffer.length = 04h 
dstOffset = OOh 
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8 


Compare dstBuffer using arrayCompare() 

src = {41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 

length = 04h 


Result of arrayCompareO is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 02h 








Text String TLV = OD 03 04 42 43 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 


Result of copyTextStringO is 04h 






dstBuffer . length = 04h 
dsturrset — Uzh 






10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




11 


Call the getValueLengthQ method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 








Text String TLV = OD 7F 04 01 02 ... 7E 








Initialise dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 









Call the copyTextStringO method 


Result of copyTextStringO is 7Eh 






dstBuffer. length = 7Eh 
dstOffset = OOh 






13 


Compare dstBuffer using arrayCompare() 

src = {Olh, 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getValueLengthO method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 








Text String TLV = OD 81 80 04 01 02 ...7F 








Initialise dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 






- " 


Call the copyTextStringO method 


Result of copyTextStringO is 8Fh 






dstBuff er . length = FFh 
dstOffset = lOh 






16 


Compare dstBuffer using arrayCompareO 

^rr = (OOh Olh OFh 

Olh, ...7Fh, BFh, ... FFh} 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 








Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialise dstBuffer 
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dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStrlngO method 


Result of copyTextStringO is EFh 






dstBuffer . length = FFh 

O-SLUirseL — uun 






18 


Compare dstBuffer using arrayCompareQ 

src = {Olh, ...EFh, OOh ... OOh } 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 








1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 









Call the copyTextStringO method 


Result of copyTextStringO is 04h 






dstBuffer . length = 04h 
dstUrrset — Uzn 






20 


Compare dstBuffer using arrayCompareQ 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getVaiueLengthQ method 


Result is 03h 





6.2.8.2.4 Test Coverage 



CRR number 


Test case number 


N1 


6, 8, 10, 13, 16, 18, 20 


N2 


11,14, 21 


N3 


5, 7, 9, 12, 15, 17, 19 


PI 


1 


P2 


2,3 


01 


4 



6.2.8.3 Method getAdditionallnformationLength 

Test Area Reference: API_2_PRH_GTIL 

6.2.8.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionalInf ormationLength ( ) 
throws ToolkitException 

Normal execution 

CRRNl: This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 

No requirements 
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Context errors 

CRRCl: A Tool]dtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 



6.2.8.3.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


.GTIL_ 


.l.scr 


Test Applet: 


API. 


.2. 


_PRH. 


_GTIL_ 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


_GT1L_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


GTIL_ 


.l.ch 



6.2.8.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 






ProactiveResponseHandler.getTheHandlerO ; 
call the getAdditlonallnformatlonLengthO 
method 


Result is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 





Terminal Response with 1 additional byte 

Result TLV = 03 02 02 55 






ProactiveResponseHandler.getTheHandlerQ ; 
call the getAdditionallnformationLengthO 
method 


Result is 01 h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 
command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 
call the getAddltlonallnformatlonLengthQ 
method 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 






ProactlveResponseHandler.getTheHandlerO ; 
call the getAdditionallnformatlonLengthO 
method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 


Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactlveResponseHandler.getTheHandlerO ; 


Result is BOh 
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call the getAddltlonallnformatlonLengthO 
method 






10 


Call the getValueLengthQ method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 





Terminal Response with F2h additional bytes 








Result TLV = 03 81 F3 02 55 55 55 ... 








rroaciiveriesponsenanuier.gei i nenanoiery , 
call the getAdditionallnformationLengthO 
method 


riesuit IS r^drl 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 








1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








rroaCiivenesponssnanaier.gci i nenanaicr^j , 
call the getAdditionallnformationLengthQ 
method 


ri6SUIl IS U^n 




\ 4 


oaii ine geivaiueLengin^j meinou 


riesuit IS Don 




\ 


Duiiu anu senu a uioklmt i cai coinmanu 




rilCDf AV TCYT 
UlorLA Y 1 tA 1 

Proactive command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE_E 

1 PK^PMX ic thrrt\A/n h\/ conH/\ 

L. LI 1 VI LI. 1 N 1 lo LIIILfWII UV OCIIU^^ 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthO 
method 


ToolkitException.UNAVAILABLE_E 
LEMENT Is thrown by 
getAddltlonallnformatlonLength () 





6.2.8.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1,3,5, 7, 9,11,13 


N2 


2, 4, 6, 8,10,12,14 


C1 


15 



6.2.8.4 Method getGeneralResult 

Test Area Reference: API_2_PRH_GTGR 
6.2.8.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

Normal execution 

CRRNl: This method returns the general result of a proactive command. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 

No requirements 
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Context errors 

CRRCl: A Tool]dtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV. 



6.2.8.4.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


.GTGR. 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


.GTGR. 


.l.java 


Load Script: 


APL 


_2_ 


_PRH 


_GTGR_ 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PRH_ 


_GTGR_ 


_l.ch 



6.2.8.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


Terminal Response with General Result = 00 
(command performed successfully) 






ProactiveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 





Terminal Response with General Result = 01, 
without Additional information on result 
(command performed with partial 
comprehension) 








ProactlveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 






ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




g 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
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command 





Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 
call the getGeneralResuitQ method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is 80h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 

2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResult ( ) method 


Result is 02h 




12 


Call the getValueLengthO method 


Result is 02ii 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is tiirown by send() 






ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResuitQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response without General Result 
Byte in Result Simple TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is ttirown by send() 




ProactiveResponseHandier.getTheHandierQ ; 

call the getGeneralResult ( ) method 
Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 3, 5, 7, 9, 11 


N2 


2, 4, 6, 8, 10, 12 


CI 


13 


C2 


14 



6.2.8.5 Method getltemldentifier 

Test Area Reference: API_2_PRH_GTII 

6.2.8.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method returns the item identifier byte value from the first Item Identifier TLV element. 
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CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 

Parameter errors 

No requirements 

Context errors 

CRRCl : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item Identifier 
TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is missing 
in the Item Identifier Simple TLV. 



6.2.8.5.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


GTII. 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


GTn. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GTH. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.PRH. 


_GTII_ 


.l.ch 



6.2.8.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


buiio ana sono a uioklay i tAi comniano 




UlbrLAY Itxi rroactive 
command 




available) 






Call to getltemldentlflerO with unavailable 
Item identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEIUI command 
wltfi2ltems (ID=01,02) 




SELECT ITEM Proactive 
command 


Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 






Call the getltemldentlflerO method 


Result Is 01 h 




3 


Call the getValueByteQ method 

valueOffset = OOh 


Result Is 01 h 




4 


Build and send a SELECT ITEM command 
with 3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 


Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentlflerO method 


Result Is 05h 




5 


Call the getValueByteO method 

valueOffset = OOh 


Result Is 05h 




6 


Build and send a SELECT ITEM command 
with 3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 


Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentlflerO method 


Result Is FFh 




7 


Call the getValueByteO method 

valueOffset = OOh 


Result Is FFh 




8 


Build and send a SELECT ITEM command 
with 3 Items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 
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Terminal Response with 2 Item Identifier tlv 








1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentifierO method 


Result is FFh 




9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without item identifier in 
the item Identifier Simple TLV 








Item Identifier TLV = 10 00 








Call to getltemldentifierO 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.5.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 4, 6, 8 


N2 


3, 5, 7, 9 


C1 


1 


C2 


10 



6.2.8.6 Method getTextStringCodingScheme 

Test Area Reference: API_2_PRH_GTCS 
6.2.8.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

Normal execution 

CRRNl: This method returns the data coding scheme from the first Text String TLV element. 
CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 
No requirements 

Context errors 

CRRCl: A ToolldtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is present 
with a length of 0. 



6.2.8.6.2 Test Suite files 



Test Script: 


API. 


.2. 


_PRH. 


.GTCS. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.GTCS. 


.l.java 


Load Script: 


API. 


.2. 


_PRH. 


.GTCS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


.GTCS. 


.l.cb- 
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6.2.8.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


Terminal Response (no Text String TLV 
element available) 






Call to getTextStringCodingSchemeQ with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 






Call the getTextStrlngCodlngSchemeO 
method 


OUT_OF_TLV_BOUN DARI ES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 01 h, dcs 

= 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStrlngCodlngSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 






Call the getTextStrlngCodlngSchemeO 
method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is 03h 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 






Call the getTextStringCodlngSchemeO 
method 


Result is 08h 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 






Call the getTextStringCodlngSchemeO 
method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is 80h 
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11 

- - - 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text lengtli = EFh, 
DCS = 08h 

Text String TLV = OD 81 FO 08 01 02 ... EE 

EF 









Call the getTextStringCodingSchemeQ 
method 


Result is 08h 




12 


Call the getVaiueLengthQ method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 

2nd Text String TLV = OD 03 08 42 43 






Call the getTextStringCodingSchemeQ 
method 


Result is 04h 




14 


Call the getValueLengthO method 


Result is 02h 





6.2.8.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 7, 9, 11, 13 


N2 


4, 6, 8, 10, 12, 14 


CI 


1 


02 


2 



6.2.8.7 Method GetTextStringLength 

Test Area Reference: API_2_PRH_GTTL 
6.2.8.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getXextStringLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl : The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 

No requirements 

Context errors 

CRRCl: A ToolldtException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 
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6.2.8.7.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.GTTL. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.GTTL. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GTTL. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.PRH. 


.GTTL. 


.l.clr 



6.2.8.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 





Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringLengthO method 


Result is OOh 




3 


Call the getValueLengthO method 


Result is OOh 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 






Call the getTextStringLengthO method 


Result is 01 h 




5 


Call the getValueLengthO method 


Result is 02h 




6 




Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 




10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringLengthO method 


Result is 7Fh 
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11 


Call the getValueLengthO method 


Result is 80h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 

EF 








Call the getTextStringLengthO method 


Result is EFh 




13 


Call the getValueLengthO method 


Result is FOh 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 






Call the getTextStringLengthO method 


Result is 01 h 




15 


Call the getValueLengthO method 


Result is 02h 





6.2.8.7.4 Test Coverage 



CRR number 


Test case number 


1 


2, 4, 6, 8, 10, 12, 14 


2 


3, 5, 7,9,11,13,15 


3 


1 



6.2.8.8 Method getTheHandler 

Test Area Reference: API_2_PRH_GTHD 

6.2.8.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 

No requirements 

Context errors 

CRRCl: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

6.2.8.8.2 Test Suite files 

Test Script: API_2_PRH_GTHD_l.scr 
Test Applet: API_2_PRH_GTHD_1 .Java 
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Load Script: API_2_PRH_GTHD_l.ldr 
Cleanup Script: API_2_PRH_GTHD_l.clr 



6.2.8.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandierQ 


The reference shall be a 
ProactiveResponseHandler 




3 


getTheHandlerO 


The reference shall not be null 





6.2.8.8.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 

Framework tests and 
insert here cross 
reference 


C1 


To be checked in 
Framework tests and 
insert here cross 
reference 



6.2.8.9 Method getLength 

Test Area Reference API_2_PRH_GLEN 

6.2.8.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl: returns the length in bytes of the TLV hst. 

Parameter errors 
Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



6.2.8.9.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.clr 
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6.2.8.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandier.getTheHandierQ 

getLength ( ) 


Result of getLengthQ is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerO 
getLengthO 


Result of getLengthO is FFh 





6.2.8.9.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 
Proactive Response 
Handler 



6.2.8.10 Method copy 

Test Area Reference API_2_PRH_COPY_BSS 

6.2.8.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV hst contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUNDARlES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.10.2 Test Suite files 

Test Script: API_2_PRH_COPY_BSS_l .scr 
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Test Applet: API_2_PRH_COPY_BSS_l Java 

Load Script: API_2_PRH_COPY_BSS_l.ldr 
Cleanup Script: API_2_PRH_COPY_BSS_l.clr 



6.2.8.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 








command 




Terminal Response witliout Additional 








Information in General Result TLV: 








81 03 01 21 00 02 02 82 81 03 01 00 








ProactiveResponseHandler.getTheHandler() 


NullPointerException is thrown 






copy^j wiin NULL as parameiGr lo usiDUTier 






d. 


uStUTTset > ustDuner.iengin 


Array IndexOutOfBoundsExceptio 






dstBuff er . length = 5 


n is thrown 






dstOffset = 6 








dstLength = 






3 


dstuttset < 


ArraylndexOutOfBoundsExceptio 






dstBuff er . length = 5 


n is thrown 






dstOffset = -1 








dstLength = 1 






4 


dstLength > dstBuffer.length 


ArraylndexOutOfBoundsExceptio 






dstBuff er . length = 5 


n is thrown 






dstOffset = 








dstLength = 6 






5 


dstOffset + dstLength > dstBuffer.length 


ArraylndexOutOfBoundsExceptio 






dstBuffer.length = 5 


n is thrown 






dstOffset — 3 








dstLength = 3 






6 


dstLength < 


ArraylndexOutOfBoundsExceptio 






dstBuffer.length = 5 


n is thrown 






UbLWrrbeL — U 








dstLength = —1 






7 


dstLength > length of the simple TLV list 


ToolkitException.OUT OF TLV 






dstBuffer.length = 13 


BOUNDARIES is thrown 






dstOffset = 








dstLength = 13 






8 


Successful call, dstBuffer Is the whole buffer 


Result of copyO is 1 2 






dstBuffer.length = 12 






dstOffset = 








ustLengtn — iz 






9 


Compare the buffer with buffer: 


Result of arrayCompareO is 






81 03 01 21 00 02 02 82 81 03 01 00 






10 


Successful call, dstBuffer is part of a buffer 


Result of copyO is 15 






dstBuffer.length = 20 








dstOffset = 3 








dstLength = 12 






11 


Compare the whole buffer 


Result of arrayCompareO is 






Reference = 








00 01 02 








81 03 01 21 00 








02 02 82 81 








03 01 00 








OF 10 11 12 13 






12 


Initialize dstBuffer 








dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer Is part of a buffer 


Result of copyO is 1 2 






dstBuffer.length = 20 






dstOffset = 3 








dstLength = 9 






13 


Compare the whole buffer 


Result of arrayCompareO is 






Reference = 








00 01 02 








81 03 01 21 00 








02 02 82 81 








OC OD OE 








OF 10 11 12 13 
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6.2.8.10.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.11 Method findTLV 

Test Area Reference API_2_PRH_FINDBB 

6.2.8.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 
Parameter errors 

CRRPl: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.11.2 Test Suite files 

Test Script: API_2_PRH_FINDBB_l.scr 

Test Applet: API_2_PRH_FINDBB_1 .Java 

Load Script: API_2_PRH_FINDBB_1 .Idr 

Cleanup Script: APl_2_PRH_FlNDBB_l.ch 
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6.2.8.1 1 .3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

QT nQ ni OT nn 
ol U J Ul Z.L UU 

82 02 82 81 

03 01 00 

03 02 01 12 








flndTLVQ with Invalid input parameter 

occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




2 


Search 1st TLV 

tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthQ method 


Result is 03h 




4 


Search 2nd TLV 

tag - 02h 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

tag = Olh 

occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

tag = 03h 
occurrence = 1 


Result is 

TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result is 01 h 




12 


Search 3rd TLV 

tag = 03h 
occurrence = 2 


Result is 

TLV FOUND CR NOT SET 




13 


Call the getValueLengthO method 


Result is 02h 




14 


Search tag 83h 

Tag = 83h 
Occurrence = 1 


F^6sult is 

TLV_FOUND_CR_NOT_SET 




15 


Search tag 82h 

Tag = 82h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 





6.2.8.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 11, 13 


N2 


2, 4 


N3 


10, 12 


N4 


6, 7,8, 9 


N5 


14,15 


PI 


1 


CI 


Does not apply for 




Proactive Response 




Handler 



6.2.8.12 Method getValueLength 

Test Area Reference API_2_PRH_GVLE 
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6.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been foimd in the 
handler. 

Parameter errors 

No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAn.ABLE_ELEMENT. 

6.2.8.12.2 Test Suite files 

Test Script: API_2_PRH_GVLE_l.scr 

Test Applet: API_2_PRH_GVLE_1 .Java 

Load Script: API_2_PRH_GVLE_l.ldr 

Cleanup Script: API_2_PRH_GVLE_l.ch 
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6.2.8.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 00 








ProactlveResponseHandler.getTheHandlerO 

GetValueLength 


ToolkitException. UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 









Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 









getValueLength ( ) 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 

7F 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is FOh 





6.2.8.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


1 



6.2.8.13 Method getValueByte 

Test Area Reference API_2_PRH_GVBYS 
6.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 
Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of TooUdtException shall be thrown. The reason code 
shall be TooUdtException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
TooUdtException H ANDLER_NOT_AV AIL AB LE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.13.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.GVBYS. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.GVBYS. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GVBYS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.PRH. 


.GVBYS. 


.l.ch 



6.2.8.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactlveResponseHandler.getTheHandlerO 








getValueByte (0) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte (3) 


ToolkitException. OUT OF TLV 
BOUNDARIES is tlirown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte (2) 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 82li (Source) 




5 


Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 






getVal-ieByte (7E) 


Result is 7Eh 




7 


GetValueByte (7F) 


Result is 7Fh 




8 


GetValueByte (EF) 


Result is EFh 
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6.2.8.13.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


1 



6.2.8.14 Method copy Value 

Test Area Reference API_2_PRH_CPYVS_BSS 
6.2.8.14.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[l dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.14.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.CPYVS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.CPYVS. 


.BSS. 


.l.java 


Load Script: 


APT 


_2_ 


_PRH 


CPYVS. 


BSS_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


.CPYVS. 


.BSS. 


.l.clr 
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6.2.8.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactlveResponseHandier.getTheHandierO 

Select Text String TLV 








U kJy V ci-L UC \i WJ_L.ii a. ilUJ_J_ (_l o L. IJ U J. J. t: i. 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 

U-bLJ-ifcrliyLIl — 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


ustLengtn < u 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES IS thrown 




10 


ValueOffset + dstLength > Text String length 

ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler 








CopyValue 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12_ 


Select Text String TLV 








^llPPP^^flll Cflll 

ValueOffset = 
DstBuffer.length = 17 
DstOffset = 
DstLength = 17 






13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

ValueOffset = 2 


Result of copyValueQ is 15 
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DstBuffer. length = 20 
n Q-i- n-F-Fcto-i- — 9 

UoHJ-LJ-ocL. — J 

DstLength = 12 






15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.8.14.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Response 




Handler 


C2 


11 



6.2.8.15 Method compare Value 

Test Area Reference API_2_PRH_CPRVS_BSS 
6.2.8.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

Compares the last found TLV element with a buffer: 
CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 
CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVA1LABLE_ELEMENT. 



6.2.8.15.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.15.3 



Test Suite files 

API_2_PRH_CPRVS_BSS_1 .scr 
API_2_PRH_CPRVS_BSS_1 .Java 
API_2_PRH_CPRVS_BSS_1 .Idr 
AP1_2_PRH_CPRVS_BSS_1 .ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 

belect iext otring iLV 








compareValueO with a null compareBuffer 


NullPointerException is tlirown 




2 


compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 

compareOffset = -1 

compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


vaiuc^TTSci > 1 cAi Oiling Lcngin 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


TnnlL-i+Pv^Qr^tirin IT OP Tl \/ 
1 OOlKITCXCcpilOn.LJU 1 wr 1 LV 

BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 
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Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








CompareValue ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


Seiect Text String TLV 








Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

ValueOffset = 
CompareOf f set = 
CompareLength = 17 


Result is OOh 




13 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Rpci lit jc; -ul 




15 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

ValueOffset = 2 
CompareOf f set = 3 
CompareLength = 12 


Result is OOh 




16 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Rpciilt ic -1 




17 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.8.15.4 Test Coverage 



CRR number 


Test case number 


Ml 


12, 15 


N2 


13, 16 


N3 


14, 17 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for 




Proactive Response 




Handler 


02 


11 



6.2.8.16 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference API_2_PRH_FACYB_BS 



ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



211 



ETSI TS 101 955 V7.4.1 (2002-03) 



6.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl : looks for the first occurrence of a TLV element from the beginning of a TLV hst and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 
Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAlLABLE. 



6.2.8.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.16.3 



Test Suite files 

API_2_PRH_FACYB_BS_1 .scr 
API_2_PRH_FACYB_BS_1 .java 
API_2_PRH_FAC YB_BS_1 .Idr 
AP1_2_PRH_FACYB_BS_1 .ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








FindAndCopyValue ( ) with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 

dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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dstOffset = 5 






6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 






._. 


findAndCopyValueO 

tag = 04h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




7 


Successful call 

Tag = ODh 

DstBuffer. length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

DstBuffer. length = 20 

o U W J- J- O C U — ^ 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactlveResponseHandler.getTheHandlerO 






- - 


Successful call 

Tag = ODh 

DstBuffer. length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponselHandler.getThel-landlerO 








Successful call (with tag 8Dh) 

Tag = 8Dh 

DstBuffer . length = 17 
DstOffset = 


Result of findAndcopyValueO Is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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1 col i^aoc iiuiiiuci 


M1 
i>i 1 




N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PRH_FACYBBS_BSS 

6.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPoinrerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV hst and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NuUPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.17.2 Test Suite files 

Test Script: API_2_PRH_FACYBBS_BSS_l.scr 
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Test Applet: API_2_PRH_FACYBBS_BSS_1 .Java 

Load Script: API_2_PRH_FACYBBS_BSS_l.ldr 
Cleanup Script: API_2_PRH_FACYBBS_BSS_l.clr 



6.2.8.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 









f^i'(-^ -^f- f IT f n rfn f- i-i ri r fi 1 l^nrllc^r rifitTln-il linrl 1 ak/A 

r^roacii v6n6spons6nanai6r.y6i i nsnanaicr^^ 








flndAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


d^tL^nath ^ dstBuffer Ipnath 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArravlnHpxOi itOf Rni inH^iFYr'pntin 

n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 

dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 

dstLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 

dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 
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findAndCopyValueO 

tag = ODh 

occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is ttirown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is tiirown. 




12 


Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 2 
DstBuff er . length = 20 
DstOffset = 3 
DstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

Buffer = 

55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 (no specific DCS 

byte) 








ProactlveResponseHandler.getTheHandlerQ 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

Tag = ODh, occurrence = 2 
ValueOffset = 
DstBuff er . length = 6 
DstOffset = 
DstLength = 6 


Result of findAndCopyValueO is 
6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandier.getTheHandlerQ 









Successful call (with tag 8Dh) 

Tag = 8Dh, occurrence = 1 
ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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1 col WClOC 1 lUI 1 lUCI 


IM 1 


-|0 HC "17 -|Q 




1 1 


N3 


12, 14, 16, 18 


N4 


20, 21 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PRH_FACRB_BS 

6.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte [ ] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.18.2 Test Suite files 

Test Script: APl_2_PRH_FACRB_BS_l.scr 
Test Applet: API_2_PRH_FACRB_BS_1 .java 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 217 ETSI TS 101 955 V7.4.1 (2002-03) 

Load Script: API_2_PRH_FACRB_BS_l.ldr 
Cleanup Script: API_2_PRH_FACRB_BS_l.clr 



6.2.8.18.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


comnflrpOff^pt ^ onmnarpBiiffpr ipnnth 

tag = ODh 

compareBuff er . length = 20 
compareOf f set = 21 


ni 1 dy II lucAv^uLwi Duui iijoi^ai_>c|jlili 

n is thrown 




3 


compareOffset < 

CompareBuf fer . length = 20 

compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

CompareBuf fer . length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




5 


CompareOffset + length > 

CompareBuffer.length = 20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n IS tnrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 









fIndAndCompareValueO 

tag = 04h 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 







Call the getValueLengthO method 


Tooll<itExGeption .UNAVAILABLE 
ELEMENT is thrown. 




7 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 









Compare buffers 

Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

GetValueLength 


Result is 1 7 




9 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 






- - 


Compare buffers with same parameters 


Result is +1 




11 


Initialise compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOffset = 2 


Result is OOh 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
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OD 06 00 11 22 33 44 55 








ProactiveResponseHandier.getTheHandierO 








initialise compareBuffer 

1 L L kJ Cl-LvI^lJUA-L-LvI^-L — 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

r~i m T" ci O "F "F c: "h = 9 


Result is OOh 




13 


Initialise compareBuffer 

\^ L^ILILJCL i- C^O Li. J L _L — 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 









Compare buffers 

f~i m i~i ;^ T" o O "f "F Q o "h = '9 


Result is -1 




14 


Initialise compareBuffer 

C omp 3r"sBuffsir = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 









ProactiveResponseHandier.getTheHandlerQ 








initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

Tag = 8Dh 
CompareOf f set = 


Result is OOh 





6.2.8.18.4 Test Coverage 



CRR number 


Test case number 


Ml 


6 


N2 


8 


N3 


7,11,12 


N4 


9, 13 


N5 


10, 14 


N6 


15 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 




Proactive Response 




Handler 



6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PRH_FACRBBS_BSS 
6.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag. 
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byte occurence, 
short valueOffset, 
byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 
CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 
CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 
CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.19.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


.FACRBBS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


.FACRBBS. 


.BSS. 


.l.java 


Load Script: 


API. 


.2. 


PRH. 


.FACRBBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


.FACRBBS. 


BSS. 


.l.ck 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 220 ETSI TS 101 955 V7.4.1 (2002-03) 



6.2.8.19.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 






ProactivpRp^nnn'^pHandlpr nptThpHanrllprn 








findAndCompareVaiueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


Array 1 ndexOutOf Bou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 

compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 

compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + compareLength 

>compareBuf f er . length 
CompareBuffer . length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 

compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactlveResponseHandier.getTheHandlerQ 






valueOffset ^ Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 

compareOffset = 

compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + comoareLenoth > Text Strina 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


TnnlkitExrpntion OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

Occurrence = 


ToolkitException.BADJNPUT_P 
ARAMETER is thrown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 






ProactiveResponseHandler.getTheHandlerQ 






Select a TLV (tag 02h) 
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findAndCompareVaiueQ 

tag = ODh 

occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 






Cail tlie getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




13 


initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 









findAndCompareVaiueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

GetValueLength 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 









Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 

08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactlveResponseHandler.getTheHandierO 









Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareVaiueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareVaiueQ 


Result is OOh 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



222 



ETSI TS 101 955 V7.4.1 (2002-03) 





tcitj = ODh, occuirirsncs = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 






22 


Initialise compareBuffer 

compareBuf f er = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialise comnareRuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result Is OOh 





6.2.8.19.4 Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20, 21 


N4 


15, 18, 22 


N5 


16, 19 


N6 


23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for 




Proactive Response 




Handler 



6.2.9 Class ToolkitRegistry 
6.2.9.1 Method allocateTimer 

Test Area Reference: API_2_TKR_ATIM 

6.2.9.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) throws ToolkitException 

Normal execution 

CRRNl: the returned timer identifier shall be between 01 and 08 inclusive. 

CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 223 ETSI TS 101 955 V7.4.1 (2002-03) 

CRRN3: The SIM Toolkit Framework shall trigger the applet when receiving an ENVELOPE(TIMER 
EXPIRATION) command for the allocated timer. 

CRRN4: A call to isEventSet() method for EVENT_TIMER_EXPIRATION should return true if the applet has at 
least one timer allocated. 

Parameters error 

No requirements 

Context errors 

CRRCl: Shall throw a ToolkitException with reason NO_TIMER_A VAIL ABLE if all the timers are allocated. 

CRRC2: Shall throw a ToolkitException with reason NO_TIMER_AVAILABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

6.2.9.1.2 Test suite files 

Test Script: API_2_TKR_ATIM_l.scr 
Test Applet: API_2_TKR_ATIM_1 .Java 

API_2_TKR_ATIM_2.java 
API_2_TKR_ATIM_3.java 
Installation parameters: 

For this test procedure the non-volatile memory of each instance is 200 (Hexa). 
The maximum timer parameter value is as follows for each applet: 

- applet 1 (API_2_TKR_ATIM_1): 8 timers 

- applet 2 (API_2_TKR_ATIM_2): 4 timers 

- applet 3 (API_2_TKR_ATIM_3): timer 
Load Script: API_2_TKR_ATIM_l.Idr 

The load script installs the 6 instances. 
Cleanup Script: API_2_TKR_ATIM_I.clr 
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6.2.9.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(applet 1) 

8 * allocateTimer ( ) . 


No exception shall be thrown. 
Timer ID returned shall be between 
01 and 08 inclusive. It shall be 
different after each call. 




2 


Allocate timers more than the maximum 
(applet 1) 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 
ENVELOPE(TIMER_EXPIRATION) command 
(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Calls releaseTimer ( id) each time a timer 
expires . 


Shall trigger each time an 
ENVELOPE(TIIVIER EXPIRATION) 
is sent to the SIM, for Timer ID = 
'01 'to '08'. 




4 


Allocate up to 4 timers 
(applet 2) 

4 * allocateTimer . 


No exception shall be thrown. Each 
time, the returned timer identifier 

shall be between '01' and '08' 
inclusive. It shall be different after 
each call. 




5 


Allocate timers more than the maximum 
(applet 3) 

The applet 3 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





6.2.9.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


1 


CI 


2 


C2 


5 



6.2.9.2 Method changeMenuEntry 

Test Area Reference: API_2_TKR_CMETB_BSSBZBS 
6.2.9.2.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry (byte id, 

byte[] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier, 
short iconldentif ier) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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Normal execution 

CRRNl: The SIM Toolkit Framework shall dynamically update the menu stored in the ME by issuing a SET UP 
MENU proactive cotnmand.The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true before and after the call. 

CRRN4: if helpSupported was true then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

CRRN5: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN6: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 

command qualifier = '80' 

CRRN7: if helpSupported was false and if no entries is supporting help then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return false . 

CRRN8: if helpSupported was false and if no entries is supporting help then after the completion of the SETUP 
MENU command, if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the 
SIM, then the SIM Toolkit framework shall not trigger the applet. 

CRRN9: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRNIO: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRNl 1 : If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to as defined in GSM 11.14 [4]. 

Parameters error 

CRRPl: Shall throw java.lang.NuUPointerException - if menuEntry is null 

CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 

bounds 

CRRP4: Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 

Context errors 

CRRCl: Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the Menu Identifier isn't 

associated to the calling applet instance. 

CRRC2: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

6.2.9.2.2 Test suite files 

Additional requirements for the GSM personalisation: 
- content of EF sume shall be: 
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- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_CMETB_BBSSBZBS_l.scr 
Test Applet: API_2_TKR_CMETB_BBSSBZBS_1 .Java 

- entry 'Ol'is "Initl" 

- entry '02' is "Init2" 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 

- Position /Identifier for each menu entry: '017'01','027'02' 
Load Script: API_2_TKR_CMETB_BBSSBZBS_l.ldr 
Cleanup Script: API_2_TKR_CMETB_BBSSBZBS_l.ch 
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6.2.9.2.3 



Test procedure 



1 



Description 



API Expectation 



APDU Expectation 



Applet changes the entry's title by menuEntry 
buffer, with a greater length than the initial 
length 

1- ChangeMenuEntry ( ) with parameters: 
Id = '02' 

MenuEntry = "UseAllBuf f er " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- shall return true. 

3- shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 



Changing the title with part of menuEntry 
buffer 

1- ChangeMenuEntry with parameters: 
Id = ' 01 ' 

MenuEntry = "UsePartOfBuf f er " 

Offset = 3 
Length = 12 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command whicli contains 
the new text for entry ID 
'01'. 



Length = 

1- ChangeMenuEntry ( ) for entry '01' and 
entry '02', with parameters: 

Id = '01'/'02' 
MenuEntry = "LengthEqualsO" 
Offset = 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- IsEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
for entry '01 'and entry '02', 
no text part. 



Setting a next action indicator != 



1- ChangeMenuEntry with parameters: 
Id = ' 02 ' 

MenuEntry = "NextActionlndic" 
Offset = 

Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 
HelpSupported = false 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Items Next Action Indicator 
list and which contains a 
command qualifier '80'. 
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IconQualif ier = 
Iconldentif ier = 








2- isEventSet (EVENT_MENU_SELECTION) . 








3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 

4- changeMenuEntry ( ) with parameters: 








Id = '02' 

MenuEntry = "NextActionlndic" 

urrseTi — u 

Length = menuEntry . length 
Next Act ion = '10' (SETUP CALL) 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 






5 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 


Applet is trigged by a 
l\/IENU_SELECTION_HELP_REQU 
EST and tlie Item Identifier is 02 




6 


help supported=true 

1- ChangeMenuEntry with parameters: 
Id = '01' 

MenuEntry = "HelpSupported" 

Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 


7 


Checking applet is triggered by a 
l\/IENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 


Applet is trigged by a 
IV!ENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 01 




8 


Setting Icons, help supported = false 

1- ChangeMenuEntry ( ) for entries 
'01', '02', with parameters: 

Id = '01'/'02' 

MenuEntry = " IconQualif ier " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = '01' 
Iconldentif ier = '02' / '01' 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1 - No exception shall be thrown. 

2- Shall return true. 

O OIIClll ICIUIII IdloC 


The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 


9 


MenuEntry Is disabled 

1- disableMenuEntry ( ' 01 ' ) . 

2- ChangeMenuEntry () with parameters: 


1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall return true. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List Simple TLV 
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Id = '01' 

MenuEntry = "EnableEntry " 

Offset = 

Length = menuEntry . length 
Next Act ion = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 

3- isEventSet (EVENT_MENU_SELECTION) . 

4- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


4- Shall return false. 




10 


MenuEntry is nuii 

changeMenuEntry ( ) with : 
MenuEntry = NULL 


Shall throw 

java.lang.NullPointerException. 




11 


Offset causes access outside array bounds 

Id = '01' 

MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




12 


Big Offset causes access outside array bounds 

Id = '01' 

MenuEntry = "Violation" 
Offset = 255 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




13 


Offset < causes access outside array bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = -1 
Length = 1 
NextAction = 

HelpSupported = false 
IconQualifier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




14 


Length causes access outside array bounds 

Id = '01' 

MenuEntry = "Violation" 
Offset = 

Length = MenuEntry . length + 1 
NextAction = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




15 


Length < causes access outside array 
bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 

Offset = 
Length = -1 
NextAction = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 0. 


Qhall thrnw 

1 1 Cll 1 LI 1 1 U vV 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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16 


Both offset and length causes access outside 
array bounds 

Id = ' 01 ' 

Offset e [1, MenuEntry . length] 
Length = MenuEntry . length 
NextAction = 1 

HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




17 


Invalid ID used 

Id = '00' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
MENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID Isn't allocated to a menu entry of this applet 
instance 

Id = ' OA' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
reason code: 

MENU_ENTRY_NOT_FOUND. 




19 


The text Is bigger than the allocated space 

Id = '02' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length > 15 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
reason code: 

ALLOWED_LENGTH_EXCEEDED. 




20 


With a smaller text length than the Initial length 

1. changeMenuEntry ( ) with parameters: 

Id = ' 02 ' 

MenuEntry ^ "Init" 
Offset = 

Length - menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2 . isEventSet (EVENT_MENU_SELECTION) 
3. 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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6.2.9.3 Method clearEvent 

Test Area Reference: API_2_TKR_CEVTB 
6.2.9.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (byte event) 

throws ToolkitException 

Normal execution 

CRRNl : A call to isEventSet() method for a cleared event should return false after a call to clearEvent. 

CRRN2:The SIM Toolkit Framework shall not trigger the applet on the occurrence of the cleared event anymore. 

CRRN3: if event was EVENT_CALL_CONTROL_BY_SIM and after the call, no applet is registered to it, The SIM 
Toolkit Framework shall allow an applet to register to this event. 

CRRN4: if event was EVENT_CALL_CONTROL_B Y_SIM and one applet is still registered to these event. The 
SIM Toolkit Framework shall not allow an applet to register to this event. 

CRRN5: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SlM and after the call, no applet is 
registered to it. The SIM Toolkit Framework shall allow an applet to register to this event. 

CRRN6: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM and one applet is still registered to 
these event. The SIM Toolkit Framework shall not allow an applet to set this event. 

Parameters error 

CRRPl: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION. 

CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECT10N_HELP_REQUEST. 

CRRP3: ShaU throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_TIMER_EXPIRATION. 
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CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_STATUS_COMMAND. 

Context errors 

No requirements 

6.2.9.3.2 Test suite files 

Test Script: API_2_TKR_CEVTB_l.scr 

Test Applet: API_2_TKR_ CEVTB _1 Java 

As default but applet registers to an event list which contains all defined events in GSM 03.19 [7] excepted 
those that aren't allowed or supported by setEvent(). 

Load Script: API_2_TKR_ CEVTB_1 .Idr 

Cleanup script: API_2_TKR_ CEVTB_1 .clr 



6.2.9.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from 1 to 127 excepted 
those that aren't allowed 
(EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQDEST, 
EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND) , 
the applet calls: 

1- clearEvent { ) method 

2- isEventSetO method 


1 - No exception is thrown each 
time. 

2- Sliall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED events, 
the applet calls setEventO method. 

2- For events ranging from 1 to 127 
excepted those that aren't allowed, the 
applet calls: 

2.1- clearEvent ( ) method 

2.2- isEventSetO method 


1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 




3 


Clearing NOT ALLOWED events 

For each event among: 

EVENT_MENU_SELECTION, 

EVENT_MENU_SELECTION_HELP_REQDEST, 

EVENT_TIMER_EXPIRATION, 

EVENT_STATUS_COMMAND 

1- The applet calls clearEvent (event) 
method. 


1 - Each time, clearEvent shall 
throw a Toolkit Exception with 
reason EVENT_NOT_ALLOWED. 




4 


Checking applet Isn't triggered by an 
ENVELOPE(SMS-PP DOWNLOAD) command 

1 - reset and initialise the card 

2 - An ENVELOPE (SMS-PP DOWNLOAD) is sent 
with a TAR referencing applet. 


Applet is not trigged by an 
ENVELOPE(SMS-PP 
DOWNLOAD) command 
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6.2.9.4 Method disableMenuEntry 

Test Area Reference: API_2_TKR_DMETB 

6.2.9.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRNl: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to disableMenuEntry() method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to disableMenuEntryO method. 

CRRN3: After invocation of this method the SIM Toolkit Framework shall dynamically update the menu stored in 
the ME. 

CRRN4: After invocation of this method, if there is no more enabled menu entries then the SIM Toolkit framework 
shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV with a length of 
zero and no value part. 

Parameters error 

No requirements 

Context errors 

CRRC 1 : shall throw a ToolkitException with reason = ENTRY_NOT_FOUND if the menu entry doesn't exist for 
this applet 

6.2.9.4.2 Test suite files 
Additional requirements for the GSM personalisation: 

- content of EE sume shall be: 

- Tide Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_DMETB_l.scr 
Test Applet: APl_2_TKR_DMETB_l.java 

Installation parameter: 

Same as default applet but with: 
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- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

- Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_DMETB_l.ldr 

Cleanup script: API_2_TKR_DMETB_l.ck 



6.2.9.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialise the card 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1- Shall return true 

2- Shall return false 


1- The SIM shall issue a 
SET UP IVIENU proactive 
command with entry '01' 
ano . 


2 


Check the menu state after 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 








1- disableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1 - No exception shall be thrown. 
?- Shall rptiirn triip 
3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 
disabling a previously enabled entry 
registered to 
EVENT_IUIENU_SELECTION_HELP_REQUEST 








1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


2- Shall return true 

3- Shall return true 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 
disabling a previously enabled entry 
registered to 
EVENT_IVIENU_SELECTION_HELP_REQUEST 








1- disableMenuEntry (' 02 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to 'FF' except 
'01' and '02', the applet calls 
disableMenuEntry ( ID) method. 


Each time a Toolkit Exception with 
l\/IENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 
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CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


C1 


5 



6.2.9.5 Method enableMenuEntry 

Test Area Reference: API_2_TKR_EMETB 

6.2.9.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRNl: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to enableMenuEntryQ method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to enableMenuEntryQ method. 

CRRN3:The SIM Toolkit Framework shall dynamically issue a SETUP MENU proactive connmand which does 
contain an ITEM SIMPLE TLV object for this entry. 

Parameters error 

No requirements 

Context errors 

CRRC 1 : shall throw a ToolkitException with reason = MENU_ENTRY_NOT_FOUND if the menu entry doesn't 
exist for this applet 

6.2.9.5.2 Test suite files 

Additional requirements for the GSM personalisation: 
content of EE sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_EMETB_I.scr 
Test Applet: API_2_TKR_EMETB_1 .Java 

Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_EMETB_l.ldr 
Cleanup script: API_2_TKR_EMETB_l.ch- 
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6.2.9.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Checic menu state before 
enabling a previously disabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- isEventSet (EVENT_MENU_SELECTION) 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 

3- disableMenuEntry ( ' 01 ' ) 


1- Shall return true 

2- Shall return false 

3- No exception shall be thrown. 


3- The SIM shall issue a 
SET UP IVIENU proactive 
command with entry '02' 
only. 


2 


Check menu state after 
enaoiing a previously aisaoieu eniry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01 ' 
and '02'. 


3 


Check menu state before 
enabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 

4- disableMenuEntry (' 02 ' ) 


2- Shall return true 

3- Shall return true 

4- No exception shall be thrown 


4- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01'. 
The help information 
available flag.is not verified 


4 


Check menu state after 
enabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry (' 02 ') . 

2- isEventSet (EVENT_MENU_SELECTION) 

IsEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 

command with entries '01' 
and '02' indicating help 
supported. 


5 


Enabling Invalid entries 

For ID ranging from '00' to 'FF' except 
'01' and '02', the applet calls 
enableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
IVIENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





6.2.9.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


1,2,3,4 


CI 


5 



6.2.9.6 Method getEntry 

Test Area Reference: API_2_TKR_GETY 
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6.2.9.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntryO 
throws ToolkitException 

Normal execution 

CRRNl: returns a reference to the applet ToolkitRegistry object of the calling applet. 
CRRN2: Each successive call to getEntryO method shall return the same object. 
Parameters error 
No requirements 



6.2.9.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.6.3 



Test suite files 

API_2_TKR_GETY_1 .scr 
API_2_TKR_GETY_1 .java 
AP1_2_TKR_GETY_1 .Idr 
API_2_TKR_GETY_1 .ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Installalation 

In the constructor, the applet instance 
calls the getEntryO method. 


Retums a not null ToolkitRegistry 
instance. 




2 


Check it returns the same entry 

The applet calls the getEntryO method 
again . 


Returns the same ToolkitRegistry 
instance as for test case 1 . 





6.2.9.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



6.2.9.7 Method getPolllnterval 

Test Area Reference: API_2_TKR_GPOL 

6.2.9.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval ( ) 

Normal execution 

CRRNl: shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND event. 

CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT_STATUS_COMMAND event. 
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Parameters error 
No requirements. 

Context errors 
No requirements. 

6.2.9.7.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.7.3 



Test suite files 

API_2_TKR_GPOL_l .scr 

API_2_TKR_ GPOL_l.java 
AP1_2_TKR_ GPOL_l.ldr 
API_2_TKR_ GPOL_l.clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet Isn't registered to 
EVENT_STATUS_COMMAND 

getPollInterval ( ) . 


Shall return 0. 




2 


Requesting max duration 

1- requestPollInterval (15300) 

2- Reset and initialize the card 

3- getPollInterval 


1 - No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

requestPollInterval (POLL_SYSTEM_DURATI 

ON) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- requestPollInterval (POLL_NO_DORATION) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return 0. 





6.2.9.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



6.2.9.8 Method initMenuEntry 

Test Area Reference: API_2_TKR_IMET_BSSBZBS 
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6.2.9.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte initMenuEntry (byte [ ] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier , 
short iconldentif ier) 
throws java , lang , NullPointerExcept ion, 

java . lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 



Normal execution 

CRRNl: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a SETUP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the l" successful 
call (without an exception). 

CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true . 

CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN5: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

CRRN7: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRN8: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN9: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to 0. 

CRRNIO: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the SIM for this identifier, then the SIM Toolkit framework shall trigger the applet. 

Parameters error 

CRRPl: Shall throw java.lang.NullPointerException - if menuEntry is null 

CRRP2: Shall throw java. lang. ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw java. lang. ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

CRRP4:Shall throw java.lang. ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 
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Context errors 

CRRCl: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 

space 

CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialised (eg no more item data in applet 
loading parameter) 

6.2.9.8.2 Test suite files 

Additional requirements for the GSM personalisation: 
- content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 

- Test case trigger: 1 - Applet instantiation 

2- Menu selection 

3- Menu selection Help Supported 

Test Script: API_2_TKR_IMET_BSSBZBS_l.scr 
Test Applet: API_2_TKR_IMET_BSSBZBS_1 .Java 

Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 6 

- Position / Identifier for each menu entry: 'Ol'/'Ol', '02'/'02', '03'/'03', '04'/'04', '05'/'05', and '06'/'06' 
Load Script: API_2_TKR_IMET_BSSBZBS_l.ldr 

Cleanup script: API_2_TKR_IMET_BSSBZBS_l.clr 



6.2.9.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

MenuEntry = NULL 


Shall throw a 

java.lang.NullPolnterException. 




2 


Offset > menuEntry.length 

MenuEntry = "ToolkitTest" 

Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




3 


Offset < 

MenuEntry = "ToolkitTest" 
Offset = -1 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




4 


Offset = 255 

MenuEntry = "ToolkitTest" 

Offset = 255 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




5 


Length = menuEntry.length+1 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




6 


Length < 

MenuEntry = "ToolkitTest" 
Offset = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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Length = -1 






7 


Offset + length > menuEntry.length 

MenuEntry = "ToolkitTest" 

Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

MenuEntry = "ToolkitTest impossible" 
Offset = 
Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 1" 

Offset = 
Length — 14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) 


1 - No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- initMenuEntry ( ) 

MenuEntry = "1234567TOOLKIT TEST 2" 

Offset = 7 

Length =14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1- No exception shall be 
thrown, Shall return ID '02'. 

2- Shall return false. 




11 


Successful call, 
menuEntry with help supported 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 
Shall return ID '03' 
2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

MenuEntry = "TOOLKIT TEST 4" 

v> -L J- O C \J 

Length =14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1 - No exception shall be thrown. 
2- Shall return ID '04' 




13 


Successful call. 


1 - No exception shall be thrown. 
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menuEntry with a next action indication 

MenuEntry = "TOOLKIT TEST 5" 
Offset = 
Length = 14 

NextAction = '24' [Select Item] 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


2- Shall return ID '05' 




14 


Successful call, 
length = 

initMenuEntry ( ) 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, Shall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

MenuEntry = "ToolkitTest" 

Offset - 
Length ±± 


REGISTRY_ERROR 

ToolkitException is thrown. 




16 


Dynamic update of the menu stored by the me 

Fetch 




Card shall Send a 
SetUpMenu Proactive 
command: 

[CommandQualifier]=help 
supported 

[Alphald]="TOOLKIT TEST" 
[ltemld=1] = "TOOLKIT 
TEST1" 

[ltemld=2] = "TOOLKIT 
TEST 2" 

[ltemld=3] = "TOOLKIT 
TEST 3" 

[ltemld=4] = "TOOLKIT 
TEST 4" 

[ltemld=5] = "TOOLKIT 
TEST 5" 
[ltemld=6] = "" 
[ltemsNextAction]=0600000 
0002400 


17 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '01' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '01' 




18 


Checl< Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 02 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Checl< Applet is triggered by 
ENVELOPE(IVIENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '04' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '05' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 
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22 


Check Applet is triggered by ENVELOPE 
(IVlENU_bELECTION_HELP_REQUEST) 
command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU SELECTION 
HELP_REQUEST) command & 
IVIenu Entry ID = '03' 




23 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 





6.2.9.8.4 Test Coverage 



GRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 


N4 


22 


N5 


11,16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9,10,11,12,13,14,17,18,19,20,2 




1,23 


P1 


1 


P2 


2,3,4 


P3 


5,6 


P4 


7 


C1 


8 


C2 


14 



6.2.9.9 Method isEventSet 

Test Area Reference: API_2_TKR_IEVSB 
6.2.9.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet (byte event) 

Normal execution 

CRRNl: shall return true if the event is set in the Toolkit Registry for the applet 
CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet 
Parameters error 
No requirements. 

Context errors 

No requirements 
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6.2.9.9.2 

Test Script: 
Test Applet: 



Test suite files 

API_2_TKR_IEVSB_1 .scr 
API_2_TKR_ ffiVSB _l.java 



Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 1 

- Position / Identifier for each menu entry: '0 1 7'0 1 ' 

- Maximum number of timers: 1 
Load Script: API_2_TKR_ IEVSB_1 .Idr 
Cleanup script: API_2_TKR_ IEVSB_1 .clr 



6.2.9.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Events aren't set 

Applet calls isEventSet() for each events 
ranging from 1 to 127 excepted 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_MENU_SELECTION . 


Shall return false each time. 




2 


For EVENT_FORMATTED_SMS_PP_ENV 

1 sEvent Set ( EVENT_FORMATTED_SMS_PP_ENV) 


Shall return true. 




3 


For EVENT_MENU_SELECTION 

isEventSet (EVENT_MENU_SELECTION) 


Shall return true 




4 


After clearing 
EVENT_FORMATTED_SMS_PP_ENV 

1- clearEvent (EVENT_FORMATTED_SMS_PP_ENV) 

2- 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Setting events 

1- For each SUPPORTED and ALLOWED events 
for setEventO, applet calls: 

1.1- setEvent ( ) method 

1.2- isEventSetO method. 


1.1- No exception shall be 
thrown. 

1 .2- Shall return true each time. 




6 


For 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- isEventSet 

(EVENT_MENU_SELECTION_HELP_REQUEST) 

2- call changeMenuEntry with help 

supported 

3- IsEventSet 

(EVENT_MENU_SELECTION_HELP_REQUEST) 


1 - Shall return false. 
3- Shall return true 




7 


For EVENT_TIMER_EXPIRATION 

1- isEventSet (EVENT_TIMER_EXPIRATION) 


1- Shall return false. 
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2- call allocateTimer ( ) 

3- isEventSet (EVENT_TIMER_EXPIRATION) 


3- Shall return true 




8 


For EVENT_STATUS_COMMAND 

1- isEventSet (EVENT_STATUS_COMMAND) 

2- call 

requestPollInterval (POLL_SYSTEM_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return false. 
3- Shall return true 





6.2.9.9.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,7,8 


N2 


1,5,6,7,8 



6.2.9.10 Method releaseTimer 

Test Area Reference: API_2_TKR_RTIMB 

6.2.9.10.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void releaseTimer (byte timerldentif ier) 
throws ToolkitException 

Normal execution 

CRRNl: if it was the last allocated timer for the applet then a following call to isEventSet() method for 
EVENT_TIMER_EXPIRATION should retum false. 

CRRN2: if applet has timers allocated then a call to isEventSet(EVENT_TIMER_EXPIRATION) shall retum true. 

CRRN3: After invocation of the method the indicated timer shall be released and available for reallocation. 

CRRN4: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

Parameters error 

CRRPl: shall throw a ToolkitException with 1NVAL1D_T1MER_1D reason if the timer identifier isn't between 1 
and 8. 

Context errors 

CRRCl: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is vahd but isn't allocated to 
this applet. 

6.2.9.10.2 Test suite files 

Test Script: API_2_TKR_RTIMB_l.scr 
Test Applet: API_2_TKR_RTIMB_1 .Java 

Installation parameter: 

As Default, except max timer which is set to 8. 
Load Script: APl_2_TKR_RTlMB_l.ldr 
Cleanup script: API_2_TKR_RTIMB_ 1 .ch 
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6.2.9.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Releasing not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseXimer (ID) . 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_TIMERJD. 




2 


Releasing allocated timers 

1- 8 * allocateXimer . 

2- 7 * releaseXimer (id) . 

3- isEventSet (EVENX_XIMER_EXPIRAXION) 


1 - No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Releasing Invalid timer ID 

1^ releaseXimer (' FF ' ) method 

2- isEventSet (EVENX_XIMER_EXPIRAXION) 


1 - Shall throw a ToolkitException 
with INVALID_TIMER_ID reason 
code. 

2- Shall return true. 




4 


Releasing last timer 

1^ releaseXimer ( last timer allocated) 
2- isEventSet (EVENX_XIMER_EXPIRAXION) 


1 - No exception shall be thrown. 
2- Shall return false. 







onecKing we can aiiocaie iiiners aiier iney 

have been released 

8 * allocateXimer . 


No exception shall be thrown. 




6 


Releasing all timers. 

For 1 to 8, releaseXimer ( id) . 


No exception shall be thrown. 




7 


Checking applet isn't triggered by 

ENVELOPE (XIMER_EXPIRAXION) command 
Send ENVELOPE (XIMER_EXPIRAXION) 


Applet is not trigged by an 

ENVELOPE(TIMER_EXPIRATION) 

command 





6.2.9.10.4 Test Coverage 



CRR number 


Test case number 


N1 


4 


N2 


2,3 


N3 


5,6 


N4 


7 


P1 


1,3 


C1 


Framework 



6.2.9.11 Method requestPolllnterval 

Test Area Reference: API_2_TKR_RPOLS 

6.2.9.1 1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval ( short duration) 
throws Xooll^itException 
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CRRNl : If duration is between 1 and 15300 or equal to POLL_SYSTEM_DURATION, the applet registers to 
EVENT_STATUS_COMMAND. 

CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from EVENT_STATUS_COMMAND. 

Parameters error 

CRRPl : the method should throw a ToolkitException with REGISTRY_ERROR reason if duration is > 15300 or is 
< -1 (POLL_SYSTEM_DURATION). 



Context errors 

No Requirements. 

6.2.9.11.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.11.3 



Test suite files 
API_2_TKR_RPOLS_l .scr 
API_2_TKR_RPOLS_l .Java 
API_2_TKR_RPOLS_l .Idr 
API_2_TKR_RPOLS_l .ch 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Requesting a value between 1 and 15300 s 

1- isEventSet (EVENT_STATUS_COMMMAND) 

2- For duration ranging from 1 to 15300, 
requestPollInterval (duration) . 

3- isEventSet (EVENT_STATUS_COMMA.ND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


1- Check Applet is triggered by a STATUS 
commandreset and card initialisation 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




3 


Requesting POLL SYSTEM DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND) . 

2- 

RequestPollInterval (POLL_SYSTEM_DURATI 

ON) . 

3- IsEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialisation 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




5 


Requesting invalid duration 

For duration ranging from 15301 to 15305, 
-2 requestPollInterval (duration) 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 




6 


Requesting POLL NO DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND) 

2- requestPollInterval (POLL_NO_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 
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7 


Check Applet Isn't triggered by an STATUS 
command. 

1- reset and card initialisation 

2- Send STATUS command 


2- Applet is not trigged by a 
STATUS command 





6.2.9.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


P1 


5 



6.2.9.12 Method setEvent 

Test Area Reference: API_2_TKR_SEVTB 

6.2.9.12.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEvent {byte id) 

throws ToolkitException 

Normal execution 

CRRNl: a following call to isEventSet() method with the same event id shall answer true for the applet. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of the set event happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECT10N, 
EVENT_MENU_SELECT10N_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND 

Parameters error 

CRRPl: shall throw a ToolkitException with EVENT_NOT 

CRRP2: shall throw a ToolkitException with EVENT_NOT 
EVENT_MENU_SELECTION. 

CRRP3: shall throw a ToolkitException with EVENT_NOT 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP4: shall throw a ToolkitException with EVENT_NOT 
EVENT_TIMER_EXPIRATION. 

CRRP5: shall throw a ToolkitException with EVENT_NOT 
EVENT_STATUS_COMMAND. 

Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_SIM but another applet is akeady registered to it. 

CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is akeady registered to it. 

6.2.9.12.2 Test suite fiies 

Test Script: API_2_TKR_SEVTB_l.scr 



SUPPORTED reason if event is 0. 
ALLOWED reason if event is 

.ALLOWED reason if event is 

.ALLOWED reason if event is 

.ALLOWED reason if event is 
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Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.12.3 



API_2_TKR_SEVTB_1 .Java 
API_2_TKR_SEVTB_2.java 
API_2_TKR_SEVTB_1 .Idr 
The load script installs the 2 instances. 
API_2_TKR_SEVTB_1 .ch 

Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



1 



Applet 1 is triggered by ENVELOPE(SMS_ 
PP_FORMATTED) command. 

Send ENVELOPE (SMS_PP_FORMATTED) 



Applet 1 shall be triggered 



Setting ALLOWED and SUPPORTED events 

1- For all events defined in GSM 0319 
(from 1 to 19) and allowed: 

event_prof i le_download , 

event_formatted_sms_pp_env, 

event_formatted_sms_pp_upd, 

event_unformatted_sms_pp_env, 

event_unformatted_sms_pp_upd, 

event_unformatted_sms_cb, 

event_call_control_b y_s im, 

event_mo_short_message_control_by_sim, 

event_event_download_mt_call, 

event_event_downloa:)_call_connected, 

E VE N T_E VE NT_D0WNL0AD_CAL L_D ISCONNECTED, 

event_event_download_location_statds, 

event_event_download_user_activity, 

event_event_download_idle_screen_availabl 

E, 

event_event_download_card_reader_status 

1.1- clearEvent (event) 

1.2- isEventSet (event) 

1.3- setEvent (event) 

1.4- isEventSet (event) 

1.5- clearEvent (event) 



1.1- No exception shall be thrown. 

1 .2- Shall return false. 

1 .3- No exception shall be thrown. 

1 .4- Shall return true. 

1 .5- No exception shall be thrown. 



Event 



Call setEvent (0) 



Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED reason 
code. 



Setting EVENT_MENU_SELECTiON 

Call setEvent (EVENT_MENU_SELECTION) 



Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 



Setting 

EVENT_MENU_SELECTION_HELP_REQUEST 

Call 

setEvent (EVENT_MENU_SELECTION_HELP_REQUES 

T) 



Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 



Setting EVENT_TIMER_EXPIRATiON 

Call setEvent (EVENT_TIMER_EXPIRATION) 



Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 



Setting EVENT_STATUS_COMMAND 



Shall throw a ToolkitException with 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 250 ETSI TS 101 955 V7.4.1 (2002-03) 





Call setEvent (EVENT_STATUS_COMMAND) 


EVENT_NOT_ALLOWED reason 
code. 




8 


Setting EVENT_CALL_CONTROL_BY_SIM 

Call setEvent (EVENT_CALL_CONTROL_BY_SIM) 


No Exception shall be thrown 




9 


Setting 

EVENT MO SHORT iUIESSAGE CONTROL B 
Y_Siiyi 

Call 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM) 


No Exception shall be thrown 




1 U 


^necK appici is irigg^'^^ '^y 
ENVELOPE(CALL_CONTROL_BY_SiM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
SIM) 




1 1 


Check applet is triggered by an 
ENVELOPE(IVIO SHORT MESSAGE CONTRO 
L_BY_SIM) 

Trigger the Applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSAG 
E_CONTROL_BY_SIM) 




12 


Applet 2 is triggered by ENVELOPE(SMS 
PP_DOWNLOAD) command. 

Trigger the applet 2 


Applet 2 is trigged by an 
ENVELOPE(SMS 
PP_DOWNLOAD) command 




13 


Applet 2 registers to 
CALL_CONTROL_BY_SIM 
but it is already assigned 

setEvent (EVENT_CALL_CONTROL_BY_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet 2 registers to 
MO_MESSAGE_CONTROL_BY SIM 
but it is already assigned 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


1, 8,9,10, 11, 12 


N3 


2,4,5,6,7 


PI 


3 


P2 


4 


PS 


5 


P4 


6 


P5 


7 


C1 


13 


C2 


14 



6.2.9.13 Method setEventList 

Test Area Reference: API_2_TKR_SEVL_BSS 
6.2.9.13.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEventList (byte [ ] eventList, 

short offset, 
short length) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 
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Normal execution 

CRRNl: for all events set successfully by this method, a call to isEventSet() method should return true. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of one of the successfully registered 
events happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND. 

Parameters error 

CRRPl: shall throw a java.lang.NullPointerException if eventList is null. 

CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
boimds. 

CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

CRRP4: shall throw a java.lang.ArraylndexOutOfBoundsException if both offset and length would cause access 
outside array bounds. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION. 

CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_SIM but another applet is akeady registered to it. 

CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is akeady registered to it. 



6.2.9.13.2 
Test Script: 
Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.13.3 



Test suite files 

API_2_TKR_SEVL_BSS_Lscr 
API_2_TKR_ SEVL_BSS _Ljava 
API_2_TKR_ SEVL_BSS _2.java 
API_2_TKR_ SEVL_BSS_Lldr 
The load script installs the 2 instances. 
API_2_TKR_ SEVL_BSS_l.clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet 1 Registering all eventList buffer 

EventList = all allowed events defined in 


1 - No exception sliall be thrown. 
2- No exception shall be thrown. 
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GSM 0319: 

EVENT_PROF ILE_DOWNLOAD , 

EVENT_FORMATTED_SMS_PP_ENV, 

EVENT_FORMATTED_SMS_PP_UPD, 

EVENT_UNFORMATTED_SMS_PP_ENV, 

EVENT_UNFORMATTED_SMS_PP_UPD, 

EVENT_UNFORMATTED_SMS_CB, 

EVENT_CALL_CONTROL_BY_SIM, 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 

EVENT_EVENT_DOWNLOAD_MT_CALL, 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

, EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

1- For each event in EventList 
clearEvent (event) 



3- Each time shall return true. 

4- No exception shall be thrown. 



2- setEventList (eventList ) 

Offset = 

Length = eventList . lentgh 

3- For all events in eventList 
isEventSet (event) 

4- For each event in EventList 
clearEvent (event) 



Registering part of eventList buffer 

EventList = all allowed events defined in 
GSM 0319 (see test case 1) . 

1- For each event In EventList 
ClearEvent (event) 

2- setEventList (eventList, offset, 
length) 

Offset > 

Length = eventList . lentgh - offset 

3- For all events in eventList; 
isEventSet (event) 

4- For each event in EventList: 
clearEvent (event) 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Each time shall return true for 
events ranging from offset to 
offset+length else shall return false. 

4- No exception shall be thrown. 



Nuii buffer 



EventList = null 



Shall throw a 

java.lang.NullPointerException 
Exception 



Out of bounds offset 

Offset = eventList . length 

Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Out of bounds and big offset 



Offset = 255 
Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Offset < 



Offset = -1 
Length = 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 



Out of bounds iength 

Offset = 

Length = eventList . length + 1 



Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 
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8 


Out of bounds and big iength 

Offset = 
Length = 255 


Shall throw a 

java.lang. Array IndexOutOf Bounds 
Exception 




9 


Length < 

Offset = 
Length = -1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 




10 


Out of bounds offset + Lengtii 

Offset + length > eventList . length + 1 


Shall throw a 

iflvji Ijinn ArrPvlnHpYOiitOfRniinrl'^ 

Id V Cl. ICll lU -r^l 1 CLy 1 1 lUCAX^U L*^^! LJUU 1 IV_IO 

Exception 




11 


Event 

Call setEventList (eventList) with 

ciircjr~i'l"T."ic!"l" "inH"ii"^^'l""ii*ii^ dT7'dr~i'l" 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList ) with 
eventList indicating EVENT MENU SELECTION 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




13 


EVENT_iU1ENU_SELECTiON_HELP_REQUEST 

Call setEventList (eventList ) with 

EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




14 


EVENT_TiiUIER_EXPiRATiON 

Call setEventList (eventList ) with 
eventList indicating 
EVENT_T IMER_EXP IRAT I ON 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




15 


EVENT_STATUS_C0i\/li\1AND 

Call setEventList (eventList ) with 
eventList indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 

reason code 

EVENT_NOT_ALLOWED. 




16 


Setting EVENT_CALL_CONTROL_BY_Sii\fl 

c;(^i-Fircin1-T,i (J.i '^t D 9\ with J.i 

containing 

EVENT_CALL_CONTROL_BY_SIM S 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 


Shall not throw an exception 




17 


Cliecic applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Reset and initialise the card 
Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 

_SIM) 




18 


Check applet Is triggered by an 
ENVELOPE(MO SHORT MESSAGE CONTROL 

_BY_SIIVI) 

Trigger the applet 


Applet is trigged by an 

ENVELOPE(IVIO_SHORT_MESSA 

GE_GONTROL_BY_SIM) 




19 


Applet 2 registers to CALL_CONTROL_BY_SIM 
but it is already assigned 

setEventList (MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_BY_S IM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




20 


Applet 2 registers to 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 
but it is already assigned 
setEventList(MonoEventList,0,1 ) with 
MonoEventList containing 
EVENT MO SHORT MESSAGE CONTROL BY 
_SIM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 
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HRR niimhpr 


■ cot waoc iiuiiiud 


IM 1 


1 P 
1 




1fi 1 7 1ft 

1 \jj 1 / , 1 o 






P1 


Q 


P2 




P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


C1 


19 


C2 


20 



6.2.10 Class ViewHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EditHandler, EnvelopeHandler, ProactiveResponseHandler, ProactiveHandler. 

6.2.1 1 Class ToolkitException 

6.2.1 1 .1 Exception Constants 

Test Area Reference: API_2_TKE_CONS 

6.2.1 1 .1 .1 Conformance requirement: 
There is no API, only constants. 

Normal execution 

CRRNl: The Constants of the class ToolkitException shall all have the same name and value defined in the 
GSM03.19 . 

Parameters error 

No requirements 

Context errors 

No requirements 

6.2.11.1.2 Test suite files 
None 

6.2.1 1 .1 .3 Test procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.1 1 .2 Constructor ToolkitException 

Test Area Reference: API_2_TKE_COORS 
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6.2.11.2.1 Conformance requirement: 

The constructor with following headershall compliant to its definition in the API. 

public ToolkitException (short reason) 

Normal execution 

CRRNl: Construct a ToolkitException instance with the specified reason. 

Parameters error 
No requirements 

Context errors 
No requirements 

6.2.11.2.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: AP1_2_TKE _COORS_l .scr 

Test Applet: AP1_2_TKE _COORS_l .Java 

Load Script: AP1_2_TKE _COORS_l .Idr 

Cleanup script: AP1_2_TKE _COORS_l .ch 



6.2.11.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 19 


ToolkitException.getReasonO = 
(short) 19 





6.2.11.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1 



6.2.11.3 Method throwit 

Test Area Reference: AP1_2_TKE_THITS 

6.2.1 1 .3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static void throwit (short reason) 
throws ToolkitException 

Normal execution 

CRRNl: Throws the JCRE instance of the ToolkitException class with the specified reason. 
CRRN2: extends javacard.framework.CardRuntimeException 

Parameters error 
No requirements 
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Context errors 

No requirements 

6.2.11.3.2 Test suite files 

No additional requirements for the GSM personalisation: 

Test Script: API_2_TKE_ THITS_1 .scr 

Test Applet: API_2_TKE_ THTTS.l .Java 

Load Script: API_2_TKE_ THTTS.l .Idr 

Cleanup Script: API_2_TKE_THITS_l.clr 



6.2.11.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE Instance of ToolkltExceptlon 

with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 15 




4 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 5 





6.2.11.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


4, 5, 6 



6.3 



SIM Toolkit Framework 



6.3.1 Minimum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

6.3.1.1 ProactiveHandler 

Test Area Reference: FWK MHA PAHD 



6.3.1.1.1 

Normal Execution 



Conformance Requirement 



CRRNl : If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT UNFORMATTED SMS CB 
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EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 



6.3.1.1.2 



Test Suite Files 



Test Script: 



FWK_MHA_ PAHD_1 .scr 



Test Applet: 



FWK_MHA_ PAHD_l.java 



FWK_MHA_PAHD_2.java 



Load Script: 



FWK_MHA_ PAHD_l.ldr 



Cleanup Script: 



FWK_MHA_ PAHD_l.clr 



Parameter File: 



FWK_MHA_ PAHD_l.par 
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6.3.1.1.3 Test Procedure 



Id 


Description 


API /Framework Expectation 


APDU Expectation 


1 


Applets registration to all events and Proactive 
Handler availability with 
EVENT_PROFILE_DOWNLOAD 

Appletl is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry () for 

EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 

setEventList () for the rest of the 

events . 

Applet2 is registered to all events 

defined in [7], except 

EVENT_CALL_CONTROL_BY_SIM and 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 

Using the methods initMenuEntry () for 

EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 

setEventList () for the rest of the 

events . 

The priority of appletl is higher than 
priority of applet2 

1- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST, 
POLL_INTERVAL, SET UP IDLE MODE TEXT and 
SET UP MENU. 

2- Appletl gets the Proactive Handler 
Appletl is deregistered to 

E VENT_PROF I LE_DOWNLOAD 

3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1- Appletl is triggered 

2- No exception Is thrown. 

3- Applet2 Is triggered 

4- No exception Is thrown 




2 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection with help 
request is sent to the SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl Is triggered 

2- No GXCGption is thrown 

3- Applet2 Is triggered 

4- No exception is thrown 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



259 



ETSI TS 101 955 V7.4.1 (2002-03) 



Id 


Description 


API /Framework Expectation 


APDU Expectation 


3 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 

SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection is sent to the 

SIM 

4- Applet! gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




4 


Proactive Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad formatted is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope dataDownLoad formatted is sent 
to the SIM 

4- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Proactive Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Proactive Handler availability with 
EVENT_UNFORMATTED_CELL BROADCAST 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception Is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 

SIM 

2- Appletl gets the Proactive Handler 

3- Timer id=2 

Envelope Timer Expiration is sent to the 

SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




8 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 




1- Envelope call control by SIM is sent to 

the SIM 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 




q 


n\ja\fiivts ndiiuici dvciiiciuiiiiy wiiii 

EVENT_MO_SHORT_MESSAGE_CONTROL 

1- Envelope mo short message control by SIM 
is sent to the SIM 

2- Appletl gets the Proactive Handler 


1 - Appletl is triggered 
2- No exception is thrown 




10 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




11 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




12 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




13 


Applets triggering with 
EVENT_EVENT_LOCATION_STATUS 

1- Envelope event download location status 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




14 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

l-Envelope event download user activity is 
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Id 


Description 


API /Frameworic Expectation 


APDU Expectation 




sent to SIM 


1- Appletl is triggered 






2-Appletl gets the Proactive Handler 


2- No exception is thrown 

3- Applet2 is triggered 






3-Applet2 gets the Proactive Handler 


4- No exception is thrown 




15 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




16 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 




17 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet! gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




18 


Proactive Handier availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 





6.3.1.1.4 Test Coverage 

I CRR Number I Test Case Number 
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CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9,10,11,12, 
13,14,15,16,17,18 



6.3.1.2 ProactiveResponseHandler 

Test Area Reference: FWK_MHA_ PRHD 

6.3.1.2.1 Conformance Requirement 
Normal Execution 

CRRNl: The ProactiveResponseHandler is available after the first call to the ProactiveHandler.send method to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECT10N 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 

6.3.1.2.2 Test Suite Files 



Test Script: FWK_MHA_ PRHD_1 .scr 

Test Applet: FWK_MHA_ PRHD_1 .Java 

FWK_MHA_PRHD_2.j ava 
Load Script: FWK_MHA_ PRHD_1 .Idr 

Cleanup Script: FWK_MHA_ PRHD_1 .ch 
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Parameter File: FWK_MHA_ PRHD_1 .par 



6.3.1 .2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to all events and Proactive 
Response Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 
defined in [7], applet2 is registered to 
all events defined in [7] except 

EVENT_MO_SMS_CONTROL_BY_S IM . 

Using the methods initMenuEntry ( ) for 

EVENT_MENU_SELECTION, 

requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

1-Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
and POLL_INTERVAL, , SET UP IDLE MODE TEXT 

anQ oHjl Utr iYlUjiNU. 


1 -Appletl is triggered 
No exception Is thrown 






Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is 
called 


3- No exception Is thrown 


2- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3- 

P roactiveResponseHandler . getTheHandler ( ) 
method is called 








Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 


4- Applet2 Is triggered 






Appletl execution is finished 








Applet2 builds a proactive command DISPLAY 
TEXT. 

4- ProactiveHandler . send ( ) method is 

called 


6- No exception is thrown 


5- The proactive command 
DISPLAY TEXT Is fetched 

TERMINAL RESPONSE 




5- 

P roactiveResponseHandler . getTheHandler ( ) 
method is called 








Appletl is deregistered to EVENT_PROFILE_DOWNLOAD 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1-Envelope menu selection with help 
request is sent to the SIM 



Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is 
called 



3- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 

Appletl execution is finished 

Envelope menu selection with help request 

is sent to the SIM 



Applet2 builds a proactive command DISPLAY 

TEXT 

4- ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 

SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 

called 



3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

4- Envelope menu selection is sent to the 
SIM 



Applet2 builds a proactive command DISPLAY 
TEXT 

5- ProactiveHandler . send ( ) method is 
called 



6-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad formatted is sent 
to the SIM 



Applet builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send ( ) method is called 



3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

4- Envelope dataDownLoad formatted is sent 
to the SIM 



Applet2 builds a proactive command DISPLAY 

TEXT 

5-ProactiveHandler . send ( ) method is called 



6-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad unformatted is 
sent to the SIM 



Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 

called 



3- 

Proact IveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 



Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 

called 



5- 

Proact IveResponseHandler . getTheHandler ( ) 
method is called 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 

l-Envelope call broadcast unformatted is 
sent to the SIM 



Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 



3-ProactiveResponseHandler . getXheHandler ( ) 
method is called. 



Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 

called 



5- 

P react IveResponseHandler . getXheHandler ( ) 

method is called 



1- Appletl is triggered 



3- No exception is thrown 

4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handler availability with 
EVENT_TIIVIER_EXPIRATION 

Timer id=l 

l-Envelope Timer Expiration is sent to the 

SIM 



Applet builds a proactive command DISPLAY 

TEXT 

2-ProactiveHandler . send ( ) method is called 



3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Timer id=2 

Envelope Timer Expiration is sent to the 
SIM 



Applet builds a proactive command DISPLAY 
TEXT 

4-ProactiveHandler . send ( ) method is called 



5 -P react IveResponseHandler . getXheHandler ( ) 
method is called 

Applet2 execution is finished 



1- Appletl is triggered 



3- No exception is thrown 



4- Applet2 is triggered 



5- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



6- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 










8 


Proactive Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 
the SIM 

Applet builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getXheHandler ( ) 
method is called 


1- Appletl is triggered 
3- No exception Is thrown 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


9 


Proactive Response Handler availability with 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 

1- Envelope mo short message control by sim 
is sent to the SIM 

Applet builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler.getTheHan(iler() method is 
called 

Appletl execution is finished 


1 - Appletl Is triggered 
3- No exception Is thrown 


2- A proactive command 
DISPLAY TEXT Is fetched 
TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


10 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 


1- Appletl is triggered 






2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called. 

Appletl execution is finished 


3- No exception is thrown 

4- Applet2 is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 








4- ProactiveHandler . send ( ) method is 

called 




5- A proactive command 
DISPLAY TEXT is fetched 




5- 

P react iveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 


11 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3 ^Pr oact i veRe sponseHandler.getTheHandler {) 
method is called 

Appletl execution is finished 


3- No exception is thrown 

4- Applet2 is triggered 


TERMINAL RESPONSE 




Applet builds a proactive command DISPLAY 

TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Proactive Response hHandler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 

called 


1- Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

Proact iveResponseHandler . getTheHandler ( ) 

method is called 


6- No exception is thrown 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


13 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download location status 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 

TEXT 

4- ProactiveHandler . send { ) method is 
called 


1 - Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 


2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 

5- A proactive command 
DISPLAY TEXT is fetched 




5- 

Proact iveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


14 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2-A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getXheHandler ( ) 

method is called 


3- No exception is thrown 


TERMINAL RESPONSE 




Appletl execution is finished 


4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 

called 




0- rt proaCiive corrirnana 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

Proact iveResponseHandler . getXheHandler ( ) 
method is called 


6- No exception is thrown 




15 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 

3 - Proact iveResponseHandler . getTheHandler ( ) 
method is called 

Appletl execution is finished 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send { ) method is 

called 

5- 

P roactiveResponseHandler . getXheHandler ( ) 
method is called 


1 - Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 

6- No exception is thrown 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 

5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Proactive Response [Handler availability with 








EVENT EVENT DOWNLOAD CALL CONNECT 








ED 








l-Envelope event download card reader 


1 - Appletl is triggered 






status is sent to the SIM 








Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 












2-A proactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getXheHandler ( ) 


3- No exception is thrown 






method is called 








Appletl execution is finished 










4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4^ ProactiveHandler , send { ) method is 




uibrLAY 1 tx 1 IS fetched 




called 












TERMINAL RESPONSE 




5- 

P roactiveResponseHandler . getXheHandler ( ) 








method is called 


6- No exception is thrown 




•|7 


Prnnt^tivp Rp^nnn^p H^nHlpr fivAilnhilitv with 








EVENT_STATUS_COMMAND 








l-Status command is sent to the SIM 


1 - Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-Proact iveResponseHandler . getXheHandler ( ) 


3- No exception is thrown 






method is called 








Appletl execution is finished 










4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4- ProactiveHandler . send { ) method is 




DISPLAY TEXT is fetched 




called 












TERMINAL RESPONSE 




5- 

P roactiveResponseHandler . getXheHandler ( ) 


6- No exception Is thrown 






method is called 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Proactive Response Handler availability with 
















l-An unrecognized Envelope is sent to the 


1 - Appletl is triggered 






SIM 








Appletl builds a proactive command DISPLAY 








TEXT 












2- A proactive command 




2-ProactiveHandler . send ( ) method is called 




DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 








method is called 


3- No exception is thrown 






Appletl execution is finished 










4- Applet2 is triggered 






n X U ^ i—I Ll J Ll^o d ^I-'~iCL'^' L V ^ '_>lllillCli 1^ 




5- A proactive command 




TEXT 




DISPLAY TEXT is fetched 




4- ProactiveHandler . send { ) method is 




TERMINAL RESPONSE 




called 










6- No exception is thrown 






5- 

P roactiveResponseHandler . getTheHandler ( ) 








method is called 







6.3.1 .2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9,10,11,12,13, 
14,15,16,17,18 



6.3.1.3 EnvelopeHandler 

Test Area Reference: FWK_MHA_ ENHD 

6.3.1.3.1 Conformance Requirement 

Normal Execution 

CRRNl: The EnvelopeHandler and its content are available for all toolkit applets triggered from the invocation to 
the termination of their processToolldt method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 
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EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

Context Errors 

CRRCl: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the invocation 
to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1.3.2 Test Suite Files 



Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



FWK_MHA_ ENHD_l.scr 
FWK_MHA_ ENHD_1 .Java 
FWK_MHA_ENHD_2.java 
FWK_MHA_ ENHD_l.ldr 
FWK_MHA_ ENHD_l.clr 
FWK_MHA_ ENHD_l.par 
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6.3.1 .3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Appletl and Applet2 registration and Envelope 
Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 

defined [ 7 ] . 

Using the methods initMenuEntry ( ) for 

EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Applet2 is registered to all events 
defined [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SHORT_ME S SAGE_CONTROL_BY_S IM . 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer for 
EVENT_TIMER_EXPIRATION and setEventList 
for the rest of the events. 

2- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 

, SETUP_IDLE_MODE_TEXT , POLL_INTERVAL and 
SETUP MENU 

3- EnvelopeHandler . getTheHandler ( ) method 

is called by Appletl 
Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 

Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1 - No exception is thrown 

2- Appletl is triggered 

3- A Tooll<it exception 

MAMDI FR MOT AVAII ARI P ic 

thrown 

4- Applet2 is triggered 

5- A Tooll<it exception 
HANDLER_NOT_AVAIU\BLE is 
thrown 




2 


Envelope Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

Envelope menu selection with help request 
is sent to the SIM 

Appletl is triggered 

1- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

2- Envelope menu selection with help 
request is sent to the SIM 

3- EnvelopeHandler . getTheHandler ( ) method 

is called by Applet2 


1- No exception is thrown. 
Appletl finalizes. 

2- Applet2 is triggered 

3- No exception is thrown. 




3 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

l-Envelope menu selection is sent to the 
SIM 


1- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- Envelope menu selection is sent to the 

SIM 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is tlirown. 
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Id 
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API/Framework Expectation 


APDU Expectation 


4 


Envelope Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

4- EnvelopeHandler . getTheHandler ( ) method 

is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Envelope Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- An unformatted sms pp envelope is sent 
to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Envelope Handler availability with 
EVENT_UNFORIVIATTED_CB 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Envelope Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

1- Envelope Timer Expiration is sent to the 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

Timer id=2 

3- Envelope Timer Expiration is sent to the 

SIM 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 

Applet2 finalizes. 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




8 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_SIIVI 

l-Envelope call control by sim is sent to 


1 - Appletl is triggered 
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API/Framework Expectation 


APDU Expectation 




the SIM 

2-EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 


2- No exception is thrown. 





ETSI 



3GPP TS 11.13 version 7.4.1 Release 1998 



278 



ETSI TS 101 955 V7.4.1 (2002-03) 



Id 
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API/Framework Expectation 


APDU Expectation 


9 


Envelope Handler availability with 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

1- Envelope mo short message control by sim 
is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl. 


1- Appletl is triggered 

2- No exception is tlirow 




10 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getXheHandler ( ) method 

is called by Applet2 


1 - Appletl is triggered 

2- No exception is tlirown. 

3- Applet2 is triggered 

4- No exception is thrown. 




11 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getXheHandler ( ) method 

is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




12 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONE 
CTTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getXheHandler ( ) method 

is called by Applet2 


1- Appletl is triggered. 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




13 


Envelope Handler availiability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- EnvelopeHandler . getXheHandler () method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


14 


Envelope Handler availiability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( } method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Applet2 is triggered 

4- No exception is thrown 




15 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception Is thrown. 




16 


Envelope Handler availiability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 

3- EnvelopeHandler . getTheHandler ( ) method 

is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown. 




17 


Envelope Handler availaibility with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 

thrr»\A/ri 

LI II WWI 1 

3- Applet2 is triggered 

4- A Toolkit exception 
HANDLER_NOT_AVAIU\BLE is 
thrown 




18 


Envelope Handler availiability with EVENT 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl finalizes. 


1- Appletl is triggered 

2- No exception Is thrown. 

3- Applet2 is triggered 
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Id 
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API/Framework Expectation 


APDU Expectation 




3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


4- No exception is tlirown. 





6.3.1.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14,15,16,17,18,19,20,21 


CRRN2 


14,15,16,17,18,19,20,21 


CRRC1 


1,2,3,4,5,6,7,8,9,10,11,12,13 



6.3.1.4 EnvelopeResponseHandler 

Test Area Reference: FWK_MHA_ ERHD 

6.3.1.4.1 Conformance Requirement 

Normal Execution 

CRRNl: The handler is available for all triggered toolkit applets from the invocation of the processToolkit method 
of the toolkit applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events:. 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_UNRECOGNIZED_ENVELOPE 
CRRN2: After a call to the post method the handler is not longer available 
CRRN3: After a call to the send method the handler is not longer available 

Context Errors 

CRRCl: The handler is not available for the following events: 
EVENT_UNFORMATTED_SMS_CB 
EVENT_MENU_SELECTION 
EVENT_MENU_SELECTION_HELP_REQUEST 
EVENT_TIMER_EXPIRATION 
EVENT_EVENT_DOWNLOAD_MT_CALL 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
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EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1.4.2 Test Suite Files 



Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.1.4.3 



FWK_MHA_ ERHD_l.scr 
FWK_MHA_ ERHD_l.java 
FWK_MHA_ERHD_2.j ava 
FWK_MHA_ ERHD_l.ldr 
FWK_MHA_ ERHD_l.clr 
FWK_MHA_ ERHD_l.par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Toolkit Appletl and Toolkit Applet2 
registration and Envelope Response Handler 
availability with 
EVENT PROFILE DOWNLOAD 



1- Appletl Toolkit 1 is registered to all 
events defined in [7] . 

Using the methods InitMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Applet2 Toolkit 2 is registered to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNI ZED_ENVELOPE . 

2- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 

, SETUP_IDLE_MODE_TEXT, SETUP_MENU and 

POLL_INTERVAL. 

Appletl is triggered 

32-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

Appletl is deregistered to 
EVENT PROFILE DOWNLOAD 



1- No exception is thrown 



2- Appletl is triggered 



3- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
ttirown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Envelope Response Handler availiability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAIU\BLE is 

thrown 




3 


Envelope Response Handler availiability with 
EVENT_MENU_SELECTION 

1- A envelope menu selection is sent to the 

SIM 

The Appletl is triggered 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1 - Appletl is triggered 

2- A Tooll<it exception 
HANDLER_NOT_AVAIU\BLE is 
ttirown 




4 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_CB 

1- Envelope cell broadcast unformatted is 

o Q n 4- i- r\ 4- Vi CTTVI 
beilU UO UIlc O-Lr'l 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




5 


Envelope Response Handler availiability with 
EVENT_TIMER_EXPIRATION 

1- Envelope Timer Expiration is sent to the 
SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




6 


Envelope Response Handler availiability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2 -A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




7 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD GALL CONNECT 
ED 

l-Envelope event download call connected 
is sent to the SIM 


1- Appletl is triggered. 
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API/Framework Expectation 


APDU Expectation 




2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




8 


Envelope Response Handler availlability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl Is triggered. 

2- A Tooll<lt exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




9 


Envelope Response Handler availability witli 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- Applet A obtains the Envelope Response 
Handler 


1- Appletl Is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




10 


Envelope Response Handler availability witli 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
senu uo une o±iYi 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl Is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




11 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl Is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




12 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1 - Appletl Is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
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API/Framework Expectation 


APDU Expectation 






thrown 




13 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAII-ABLE is 
thrown 




14 


Envelope Response [Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- A formatted sms pp envelope is sent to 

the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds an additional information 
for response packet and it calls the post 
method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the sendO method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1- Appletl is triggered 

2- No exception is thrown. 

4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Appletl is triggered 

6- No Exception is thrown 

8- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


3- The response packet is 

sent 

7- The proactive command 
is sent 


15 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 
the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds the envelope response and 
it calls the postO method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- EnvelopeResponseHandler . getTheHandler ( ) 


1 - Appletl is triggered 
2- No exception is thrown. 

4- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown for each method 

5- Applet2 is triggered. 


3- The envelope response is 
sent 
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method is called 
Applet2 finalizes. 


6- A Toolkit exception 
HANDLER NOT AVAILABLE is 
thrown. 






6-A unformatted sms pp envelope is sent to 

the SIM 


7- Appletl is triggered 






7-EnvelopeResponseHandler . getTheHandler ( ) 

method is called. 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the sendO method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1 0- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 

1 1 - Applet2 is triggered 


9- The proactive command 
is fetched and the Terminal 
response is issued. 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 


12- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




16 


Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 

the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1 - Appletl is triggered 






3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 

inherited method) 

The Appletl finalizes 

5- Envelope call control by sim is sent to 
the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- No exception is thrown. 

4- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Appletl is triggered 


3- The envelope response is 
sent 




7- Appletl builds a proactive command and 
it calls the send() method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


6- No Exception is thrown 

8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


7- The proactive command 
is fetched and the Terminal 
response is issued 


17 


Envelope Response Handler availability with 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 


1- Appletl is triggered 
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2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


2- No exception is thrown. 






3-Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 




3-The envelope response is 
sent 




4-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 


4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 






5-Envelope mo short message control by sim 
is sent to the SIM 


5- Appletl is triggered 






6- EnvelopeResponseHandler . getTheHandler ( ) 

method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the send method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


6- No exception is thrown 

8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


7- The proactive command 
Is fetched and the Terminal 
Response is issued 


18 


Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- No exception Is thrown. 






3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) or post method 

4- Appletl calls all methods of Envelope 
Response Handler (including the inherited 

method) 

The Appletl finalizes 


4- A Toolkit exception 
HANDLER_NOT_AVAIU\BLE is 
thrown for each method 

5- Applet2 is triggered. 


3- The envelope response is 
sent 




54-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 

Applet2 finalizes 


6- A Toolkit exception 
HANDLER_NOT_AVAII-ABLE is 
inrown lor eacn meinoo 






6-An unrecognized Envelope is sent to the 
SIM 


7- Appletl is triggered. 






7-EnvelopeResponseHandler . getTheHandler ( ) 

method is called 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the send() method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


I U r\ I UUIIVIl CAUcUUUI 1 

HANDLER_NOT_AVAIUVBLE is 

LI II UVVI 1 IKJl CdUl 1 1 1 ICll IwU 

Appletl finalizes 

I I - Applet2 is triggered 


9- The proactive command 
Is fetched and the Terminal 
response Is issued 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 
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12- A Toolkit exception 
HANDLER_N0T_AVA1LABLE is 
thrown for each method 




19 


The envelope response Is sent when a 
proactive session Is ongoing 

1- A formatted SMS PP envelope is sent to 
the SIM. 

2- Proactive command DISPLAY TEXT is built 
and it calls the sendO method. 

3- A call control by sim envelope is sent 
to the SIM. 


1- Appletl is triggered. 
3- Appletl is triggered 


2-91 XX 




4- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

5- Appletl builds the envelope response and 
it calls the postAsBERTLV 


4- No exception is thrown 


5-The envelope response is 

sent 
9F YY 

GET RESPONSE 
Data 

91 XX 
Fetch DISPLAY TEXT 

Terminal Response 
DISPLAY TEXT 



Note: Due to an inconsistency in [7] specification it is not possible to cover the test case when an applet try to 
post data in multitriggering. 

6.3.1 .4.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14,15,16,17,18, 19 


CRRN2 


14,15,16,17,18, 19 


CRRN3 


14,15,16,17,18, 19 


CRRC1 


1,2,3,4,5,6,7,8,9,10,11,12,13 



6.3.2 Handler Integrity 

6.3.2.1 ProactiveHandler 

Test Area Reference: FWK_HIN_ PAHD 

6.3.2.1.1 Conformance Requirement 

Normal Execution 

CRRNl: At the processToolkit invocation the TLV-List is cleared. 

CRRN2: After a call to ProactiveHandler.send method the handler will remain unchanged until the 
ProactiveHandler.init or appendTLV method are called. 
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6.3.2.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files: 

FWK_fflN_ PAHD_1 .scr 
FWK_ fflN_ PAHD_l.java 
FWK_HIN_PAHD_2.java 
FWK_ HIN_ PAHD_1 .Idr 
FWK_ H1N_ PAHD_l.clr 
FWK_ HIN_ PAHD_l.par 



6.3.2.1.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



At the processToolkit invocation the TLV-List 
is cleared 



Appletl and Applet2 are registered to 
EVENT_UNFORMATTED_SMS_PP_ENV . 



1-An envelope containing an unformatted 
sms pp is sent to the SIM 



2-ProactiveHandler . getLength ( ) method is 
called by Appletl 



1- Appletl is triggered. 



2- Tine return value is 



TLV-List change after the init method 
invocation 



ProactiveHandler . init ( ) method is called 
by Appletl 

1-ProactiveHandler . getLength ( ) method is 
called by Appletl 



1 - The return value is 9 



The TLV-List remains unchanged after the 
send() method invocation 

l-ProactiveHandler . send ( ) method is called 
by Appletl 



2-Proact iveHandler . getLength ( ) method is 
called by Appletl 



It's checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copyValue and 
Util . arrayCompare methods 

Appletl finalizes 



2- The return value is 9, and its 
contents is the same than before 
the calling to send method 



1- The proactive command 
is fetched and the terminal 
response is issued. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


At the processToolkit invocation the TLV-List 
is cleared 

1- Proact iveHandler . getLength ( ) method is 
called by Applet2 

2- ProactiveHandler . getValueLength ( ) method 
is called by Applet2 


1 - Applet2 is triggered 

2- The return value is 

3- ToolkitException 
UNAVAILABLE_ELEMENT is 

thrown 





6.3.2.1 .4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4 


CRRN2 


3 



6.3.2.2 ProactiveResponseHandler 
Test Area Reference: FWK_fflN_ PRHD 

6.3.2.2.1 Conformance Requirement 

Normal Execution 

CRRNl: The ProactiveResponseHandler content is changed after the call to ProactiveHandler.send method and 
remains unchanged until next call to the ProactiveHandler.send method. 

CRRN2: The ProactiveResponseHandler may not be available before the first call to ProactiveHandler.send method, 
if available the content is cleared. 



6.3.2.2.2 Test Suite Files 



Test Script: 


FWK_HIN_ 


PRHD_ 


l.scr 


Test Applet: 


FWK_ 


HIN. 


.PRHD. 


_l.java 


Load Script: 


FWK_ 


HIN. 


.PRHD. 


_l.ldr 


Cleanup Script: 


FWK_ 


HIN_ 


_ PRHD_ 


_l.ck 


Parameter File: 


FWK_ 


HIN_ 


_ PRHD_ 


_l.par 
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6.3.2.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration and 
ProactlveResponseHandler obtaining 

1- Applet is registered to all events 

defined in [ 7 ] . 

Using the methods initMenuEntry for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
, SETUP_IDLE_MODE_TEXT, SETUP_MENU and 
POLL_INTERVAL. 

For each event : 

2- ProactiveResponseHandler . getTheHandler ( ) 
is called 

If handler is available, 
ProactlveResponseHandler . getLength ( ) is 

called 


1- No exception is thrown 

2- Applet is triggered. 

3- Behaviour 1 : 
Toolkit Exception 
HANDLER_NOT_AVAILABLE Is 
thrown. 

Behaviour 2: 

No exception Is thrown, the return 
value Is 




2 


Tlie ProactlveResponseHandler remains 
unchange after send method invocation until 
next send method Invocation 

1- Applet builds a proactive command 
ProactiveHandler . send ( ) method is called 

2 - ProactlveResponseHandler . getLength ( ) 
method is called 

3- ProactiveHandler . init ( ) method is called 

4- ProactiveHandler . send ( ) method is called 

5 - ProactlveResponseHandler . getLength ( ) 
method is called 


1 - The ProactiveResponseHandler 
contains the terminal response 

3- The return value Is 12 

4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 

5- The ProactlveResponseHandler 
contains the terminal response of 
the second proactive command 

7- The return value Is 15 


2- A proactive command Is 
fetched 

The terminal response Is sent 
with length 12 

6- A proactive command Is 

fetched 

The terminal response is sent 
with length 1 5 



6.3.2.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1 



6.3.2.3 EnvelopeHandler 

Test Area Reference: FWK_fflN_ ENHD 
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6.3.2.3.1 



Conformance Requirement 



Normal Execution 

CRRNl: The EnvelopeHandler and its content are available for all triggered toolkit applets, from the invocation to 
the termination of their processToolldt method. 

CRRN2: The SIM Toolkit Framework guarantees that all triggered toolkit applets receive the data. 



6.3.2.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 
FWK_fflN_ ENHD_1 .scr 
FWK_ fflN_ ENHD_l.java 
FWK_ HIN_ ENHD_1 .Idr 
FWK_ fflN_ ENHD_1 .clr 
FWK_ HIN_ ENHD_l.par 



6.3.2.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet initialization and Envelope Handler 
integrity checks with 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- Applet is registered to all events 
defined in [7] except 
EVENT_PROFILE_DOWNLOAD and 
EVENT_STATUS_COMMAND . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION, and setEventList ( ) 
for the rest of the events. 
Perform SIM initialization with all the 
facilities supported 

2- Envelope menu selection with help request 
is sent to the SIM 

3- EnvelopeHandler . getXheHandler ( ) method is 
called 



4- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findXLV ( ) method is 
called with TAG_HELP_REQUEST 

5- A proactive command DISPLAY TEXT is sent 

6- Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . get TheHandler ( ) method is 
called 



7- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 -No exception is thrown 



2- Applet is triggered 

3- No exception is thrown. 

4- No exception is thrown 



5- 91 XX. 



6- Applet is triggered 



7- No exception is thrown and the 
handler contains the envelope call 
control by SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 








/ \ yj \ uctoii vc LfUi 1 II 1 icii i<j 

Display Text is fetched 








The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




Check that the TAG_HELP_REQUEST is the TLV 
selected 

8-The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


8- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 




2 


Envelope Handler integrity checks with 
EVENT_MENU_SELECTION 

1- An envelope menu selection is sent to 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 

called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The Enve lopeHandler . f indTLV ( ) method is 
called with TAG_ITEM_IDENTIFIER 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler . getTheHandler ( ) method is 

called 








6- It's checked the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
nanuier coniains ine envelope can 
control by SIM 






The EnvelopeHandler . f indTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 








It's checked that the TAG ITEM IDENTIFIER 
is the TLV selected 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 
Envelope Handler integrity checks with 
EVENT_FORMATTED_SMS_PP_ENV 

1- A formatted sms pp envelope is sent to 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 

called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_SMS_TPDU 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 

EnvelopeHandler . getTheHandler ( ) method is 

called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV { ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_SMS_TPDU is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


API/Framework Expectation 

1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


APDU Expectation 

4-91 XX 

Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 


3 


4 


Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 

SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 

EnvelopeHandler . getTheHandler ( ) method is 

called 

6- It's checked that the contents of the 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 


4-91 XX 
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Id 



Description 

envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



API/Framework Expectation 

6- No exception is tlirown and the 
handler contains the envelope call 
control by SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 



APDU Expectation 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_CB 

l-A unformatted cellbroadcast envelope is 
sent to SIM 



2-EnvelopeHandler . getXheHandler ( ) method is 

called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 



The EnvelopeHandler . findTLV ( ) method is 
called with TAG_CELLBROADCAST_PAGE 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4-91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



It's checked that the 

TAG_CELLBROADCAST_PAGE is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 
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Id 


Description 
Envelope Handler integrity checks with 
EVENT_TIMER_EXPIRATION 

1- A timer expiration envelope is sent to 

SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_TIMER_ID 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_TIMER_IDE is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


API/Framework Expectation 

1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tlirown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


APDU Expectation 

4- 91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 


6 


7 


Envelope Handler Integrity checks with 
EVENT_CALL_CONTROL_BY_SIM 

1- A call control envelope is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 

called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 


4- 91 XX 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handier contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




It's checked that the TAG_ADDRESS is the 

TLV selected 

1- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 




8 


Envelope Handler integrity checks with EVENT 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 








l-A mo short message control by sim 
envelope is sent to SIM 


1 - Applet is triggered 






2-EnvelopeHandler . getXheHandler ( ) method is 
called 


2- No exception is thrown. 






3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 


o~ iNO cxcepiion is inrown. 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 




4-91 XX 




5-Envelope call control by sim is sent to 

SIM 


5- Applet is triggered 






EnvelopeHandler . get TheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare () 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 


The terminal Response of 
DISPLAY TEXT lq qpnt to 
the SIM 
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Id 


Description 

Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_MT_CALL 

1- A event download mt call envelope is sent 

to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


API/Framework Expectation 

1 - Applet is triggered 

2- No exception is thrown. 

3- No exception Is thrown. 

5- Applet is triggered 

6- No exception Is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
In buffer 1 


APDU Expectation 

4- 91 XX 

Proactive command Display 
Text Is fetched 

The terminal Response of 
DISPLAY TEXT Is sent to 
the SIIVI 


9 


10 


Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_CALL_CONNECTED 

1- A event download call connected envelope 
is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 

called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 


1 - Applet is triggered 

2- No exception Is thrown. 

3- No exception Is thrown. 

5- Applet Is triggered 


4-91 XX 
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Id 



Description 

EnvelopeHandler . getXheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



API/Framework Expectation 



6- No exception is tfirown and the 
liandler contains the envelope call 
control by SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 



APDU Expectation 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



11 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

l-A event download call disconnected 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . get TheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4-91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 



7- The contents of the envelope 
handler shall be the same as stored 
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Id 



Description 

Util . arrayCompare ( ) 



API/Framework Expectation 

in buffer 1 . 



APDU Expectation 



12 



Envelope Handler integrity checks witfi EVENT_ 
EVENT_DOWNLOAD_LOCATION_STATUS 

l-A event download location status envelope 
is sent to SIM 



2-EnvelopeHandler . getXheHandler ( ) method is 
called 



3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findXLV ( ) method is 
called with TAG_LOCATION_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . get TheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



It's checked that the TAG_LOCATION_STATUS 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the Sll^ 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


13 


Envelope Handler integrity checlcs with EVENT_ 








PUPNT nrtWNI DAD IIQPR APTIUITV 








1-A event download user activity envelope 


1 - Applet is triggered 






is sent to SIM 








2-EnvelopeHandler . getXheHandler ( ) method is 


9- Mn PYPPntinn iq thrr»\A/n 

^ 1 MU C?AOC?lJllL/l 1 lO LI 1 1 vVI 1 . 






called 








3-Copy the contents of the envelope handler 


3- No exception is thrown. 






in buffer 1 using EnvelopeHandler . copy ( ) 














called with TAG_DEVICE_IDENTITIES 








4-A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5-Envelope call control by sim is sent to 








S IM 


5- Applet is triggered 






EnvelopeHandler . getXheHandler ( ) method is 








called 








6-It's checked that the contents of the 








envelope handler is the envelope call 


6- No exception Is thrown and the 






control using EnvelopeHandler . copy ( ) and 


handler contains the envelope call 






Util . arrayCompare ( ) methods 


control by SIM 






The EnvelopeHandler . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 












Proactive command Display 








Text is fetched 








The terminal Response of 








r~\ioi~*i A \/ "T*T~\/~i~ : 1. !._ 

DISPLAY TEXT is sent to 








the oiM 




±C 5 CIlSCKecl T^IiaT^ T^IIG lAtj UiIjv ±\^tlj J-UiljiN 1 J. 1 J-ilo 








is the TLV selected 








7- The contents of EnvelopeHandler are 


7- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare () 


In buffer 1 




14 


Envelope Handler integrity checl<s witli EVENT_ 








C\/CMT n/^IA/MI I^AR ini C C^DCCM A\/AII AC 
CVCNI UUVVNLUAU lULC oUnCCN AVAILAD 








LE 








1-A event download idle screen available 


1 - Applet Is triggered 






envelope is sent to SIM 








2-EnvelopeHandler . getTheHandler ( ) method is 


2- No exception is thrown. 






called 






3-Copy the contents of the envelope handler 








in buffer 1 using EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






ine iiiR ve xopsnaiiQxe J- . r inQi j-i V ^ J lueunoci is 








called with TAG_DEVICE_IDENTITIES 








4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 




4-91 XX 




SIM 


5- Applet Is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handier contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_DEVICE_IDENTITIES 

is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




1- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handier shall be the same as stored 
in buffer 1 




15 


Envelope Handler Integrity checks with EVENT 
EVENT_DOWNLOAD_CARD_READER_STATUS 

1- A event download card reader status 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 

called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_CARD_READER_STATUS 

4- A proactive command DISPLAY TEXT is sent 


1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 

SIM 


5- Applet is triggered 


4- 91 XX 




EnvelopeHandler . getTheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 


Proactive command Display 
Text is fetched 




It's checked that the 

TAG_CARD_READER_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Envelope Handler integrity checks with 
UNRECOGNIZED_ENVELOPE 

1- A unrecognized envelope is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tlirown. 






5-Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

The EnvelopeHandler . getValueLength ( ) is 
called 


5- Applet is triggered 


4- 91 XX 




6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is tlirown and the 
handler contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text is fetched 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



6.3.2.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3, 4, 5, 6, 7, 8, 9, 10, 11, 
12, 13, 14, 15, 16 


CRRN2 


1,2,3, 4, 5, 6, 7, 8, 9, 10, 11, 
12, 13, 14, 15, 16 



6.3.3 Applet Triggering 

6.3.3.1 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: FWK_APT_EPDW 

6.3.3.1.1 Conformance Requirement 

Normal Execution 

CRRNl : Upon the reception of Terminal Profile command by the SIM, the STF stores the ME Profile and then 
triggers the registered toolkit applets. 

CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from this 
event. 
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CRRN3: The STF shall not reply busy to a Terminal Profile command 



6.3.3.1.2 

Test Script; 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter FUe: 



Test Suite Files 

FWK_APT_EPDW_1 . scr 
FWK_APT_EPDW_1 Java 
FWK_APT_EPDW_2.java 
FWK_APT_EPDW_3.java 
FWK_APT_EPDW_1 .Idr 
FWK_APT_EPDW_1 .ch 
FWK_APT_EPDW_1 .par 



6.3.3.1.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT_PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applets is not registered to the 
EVENT_PROFILE_DOWNLOAD and is registered 
to EVENT_FORMATTED_SMS_PP_ENV. 

1-Terminal Profile command is sent to SIM 



Appletl execution is finished 



Applet2 execution is finished 



1 - Appletl is triggered 



2- Applet2 is triggered 



3- Applets is not triggered 



The STF shall not reply busy to a Terminal 
Profile command 

l-Formatted sms pp envelope is sent to SIM 



Applets builds a REFRESH proactive command 
in sim initialization mode 

2-ProactiveHandler . send ( ) method is called 
by applets 



3-Terminal Profile command is sent to SIM 



Appletl calls Toolkit Registry . clearEvent ( 
E VENT_PROF I LE_DOWNLOAD ) 



1 - Applets is triggered by the 

EVENT_FORMATTED_SMS_PP_ 

ENV 



2- A proactive command is 
sent 



Applets is suspended until the 
terminal response 

S- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



4- Applet2 is triggered by 
EVENT PROFILE DOWNLOAD 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




4-Applet2 calls Toolkit 
Registry . clearEvent ( 
EVENT_PROF I LE_DOWNLOAD ) 

ToolkitRegistry . setEvent (EVENT_PROFILE_DOW 
NLOAD) method is called 

Applets execution finish 




The terminal Response of 
the proactive command is 
sent 


3 


Deregistered applets are not triggered 

Terminal Profile command is sent to SIM 


Applets is triggered 
(Appletl and Applet2 are not 
triggered) 





6.3.3.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRN3 


2 



6.3.3.2 EVENT_MENU_SELECTION 

Test Area Reference: FWK APT EMSE 



6.3.3.2.1 

Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_MENU_SELECTION when an Envelope Menu Selection is 
received with the item identifier of a menu entry of this applet if no proactive session is ongoing. 



6.3.3.2.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMSE_l.scr 
FWK_APT_EMSE_l.java 
FWK_APT_EMSE_2.java 
FWK_APT_EMSE_1 .Idr 
FWK_APT_EMSE_1 .clr 
FWK_APT_EMSE_l.par 
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6.3.3.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT_MENU_SELECTION and triggering 








ToolkitRegistry . initMenuEntry ( ) method is 








called in the constructor of appletl and 








Applet2 . 








For appletl: 








MenuEntry="Appletl " 








Offset=0 








Length=menuEntry . length 


1- Tho mothf^H miict rotiirn triio 

1 1 1 IC 1 1 ICII i\J\J 1 1 lUoL 1 CLUM 1 LI UC 






HelpSupported=f alse 








IconQualif ier=0 








Iconldentif ier=0 








For applet2 : 








MenuEntry="Applet2" 








Offset=0 








Length=menuEntry . length 








HelpSupported=f alse 








IconQualif ier=0 








Iconldentif ier=0 








event= EVENT_MENU_SELECTION 








1-ToolkitRegistry . isEventSet ( ) is called 








in constructor. 








Perform SIM initialization the facility 








SET UP MENU and without the facilities SET 








EVENT LIST and POLL INTEVAL features 










2- Appletl is triggered and applet2 






2-Item Identifier = 1 


is not triggered 






Event Menu Selection envelope is sent to 






the SIM with the item identifier of a menu 








entry of applet 










3- Applet2 is triggered and appletl 






3-Item Identifier = 2 


is not triggered 






Event Menu Selection envelope is sent to 








the SIM with the item identifier of a menu 








entry of applet 







6.3.3.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: FWK_APT_EMSH 

6.3.3.3.1 Conformance Requirement 
Normal Execution 

CRRNl: If and ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then STF shall trigger the corresponding applet. 

6.3.3.3.2 Test Suite Files 

Test Script: FWK_APT_EMSH_l.scr 
Test Applet: FWK_APT_EMSH_1 .java 
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FWK_APT_EMSH_2.java 
Load Script: FWK_APT_EMSH_l.ldr 
Cleanup Script: FWK_APT_EMSH_l.clr 
Parameter File: FWK_APT_EMSH_1 .par 



6.3.3.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT MENU SELECTION HELP REQUEST 








and triggering 








ToolkitRegistry . InitMenuEntry ( ) method is 








called in the constructor of appletl and 








Applet2 . 








For Appletl: 








MenuEntry="Appletl" 








Offset=0 








Length=menuEntry . length 








HelpSupported=true 








IconQualif ier=0 








Iconldentif ier=0 








For Applet2 : 








MenuEntry="Applet2" 








Offset=0 








Length=menuEntry . length 








HelpSupported=true 








IconQualif ier=0 








Iconldentif ier=0 








event= EVENT_MENU_SELECTION_HELP_REQUEST 


1-The command must return true. 






1-ToolkitRegistry . isEventSet ( ) is called 






in constructor. 








Perform SIM initialization the facility 








SET UP MENU and without the facilities SET 








EVENT LIST and POLL INTEVAL features 








2-Item identifier =1 


2- Appletl is triggered and applet2 






Menu Selection Help Request envelope is 


Is not triggered 






sent to the SIM with the item identifier 






of a menu entry of applet 








3-Item identifier =2 








Menu Selection Help Request envelope is 


3- Applet2 Is triggered and appletl 






sent to the SIM with the item identifier 


Is not triggered 






of a menu entry of applet 





6.3.3.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EFSE 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 307 

6.3.3.4.1 Conformance Requirement 



ETSI TS 101 955 V7.4.1 (2002-03) 



Normal Execution 

CRRNl: The applet is triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has registered to this event 
and Formatted Envelope DataDownLoad with the corresponding TAR, defined at the applet loading, is received and 
no proactive session is ongoing 

CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has deregistered from 
this event. 



6.3.3.4.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.4.3 



Test Suite Files 

FWK_APT_EFSE_1 .scr 
FWK_APT_EFSE_1 .Java 
FWK_APT_EFSE_1 .Idr 
FWK_APT_EFSE_1 .ch 
FWK_APT_EFSE_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to EVENT 
FORMATTED_SMS_PP_Em and triggering 



Applet is registered to 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNI ZED_ENVELOPE 



1-An Envelope EVENT_FORMATTED_SMS_PP_ENV 
is sent to the SIM. 



1 - Applet is triggered 



Applet deregistration 

ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

2-A formatted sms pp envelope is sent to 
the SIM. 



An unrecognized envelope is sent to the 

sim 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

3-An Envelope FORMATTED_SMS_PP_ENV is sent 
to the SIM 



2- Applet is not triggered 



3- Applet is triggered 



6.3.3.4.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EUSE 
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Normal Execution 

CRRNl: The applet is triggered by the EVENT_ UNFORMATTED_SMS_PP_ENV once it has registered to this 
event and an Unformatted Envelope DataDownLoad is received if no proactive session is ongoing 

CRRN2: The applet is not triggered by the EVENT_ UNFORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 



6.3.3.5.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EUSE_1 .scr 
FWK_APT_EUSE_1 java 
FWK_APT_EUSE_1 .Idr 
FWK_APT_EUSE_1 .clr 
FWK_APT_EUSE_1 .par 



6.3.3.5.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORIUIATTED_SMS_PP_ENV and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_PP_ENV and 
ENVENT_FORMATTED_SMS„PP_ENV . 

1- Toolkit Registry . isEventSet ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 

2- An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM. 



1- The method returns true 



2- Applet is triggered 



Applet deregistration 

Toolkit Registry . clearEvent () method is 
called for EVENT_UNFORI»TTED_SMS_PP_ENV 
1-An unformatted sms pp envelope is sent 
to the SIM. 



A formatted sms pp envelope is sent to the 
sim 

Toolkit Registry . setEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 



2-An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM 



1 - Applet Isn't triggered 



2- Applet is triggered 



6.3.3.5.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 
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6.3.3.6 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK APT ECCN 



6.3.3.6.1 



Conformance Requirement 



Normal Execution 

CRRNl: The applet is triggered by the EVENT_CALL_CONTROL_BY_SIM once it has registered to this event 
and an Envelope Call Control is received 

CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_B Y_SIM once it has deregistered from this 
event. 



6.3.3.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_ECCN_1 .scr 
FWK_APT_ECCN_1 .java 
FWK_APT_ECCN_1 .Idr 
FWK_APT_ECCN_1 .ch 
FWK_APT_ECCN_1 .par 



6.3.3.6.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT_CALL_CONTROL_BY_SIM and 
triggering 



Appletl is registered to 
EVENT_CALL_CONTROL_BY_S IM . 



Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV 

1-An Envelope Call control by SIM is sent 
to SIM 



Appletl execution is finished 



1- Appletl is triggered 



Applet deregistration and registration of the 
third applet to EVENT_CALL- 
CONTROL_BY_SIM. 

l-An Envelope Formatted SMS PP envelope is 
sent to SIM 



Applet2 contructs a DISPLAY TEXT proactive 
command . 

2-ProactiveHandler . send ( ) method is called 



3-An Envelope Call control by SIM envelope 
is sent to SIM 



1 -Applet2 Is triggered by 

EVENT_FORMATTED_SMS_PP_ 

ENV. 



2- A proactive command 
DISPLAY TEXT is sent and 
applet Is suspended until 
the terminal response 



3- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




ToolkitRegistry . clearEvent ( ) is called for 
EVENT_CALL_CONTROL_BY_S IM . 
Appletl finalizes. 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_CALL_CONTROL_B Y_S IM . 

Applet2 is finished 




TERMINAL RESPONSE of 
DISPLAY TEXT is sent to 
the SIM 


3 


Applet triggering 

An Envelope Call control by SIM envelope 
is sent ot SIM 


Applet2 is triggered. 
(Appletl is not triggered) 





6.3.3.6.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK APT EMCN 



6.3.3.7.1 

Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it has 
registered to this event and an Envelope MO Short Message Control. 

CRRN2: The applet is not triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it has 
deregistered from this event. 



6.3.3.7.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMCN_1 .scr 
FWK_APT_EMCN_1 Java 
FWK_APT_EMCN_2.java 
FWK_APT_EMCN_1 .Idr 
FWK_APT_EMCN_1 .ck 
FWK_APT_EMCN_1 .par 
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6.3.3.7.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_MO_SHORT_IVIESSAGE_CONTROL_B 
Y_SIM and triggering 

Appletl is reggistered to 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 

Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-An Envelope MO short message envelope is 
sent to SIM 

Appletl execution is finished 


1- Appletl is triggered. 




2 


Applet dereglstratlon and registration of the 

ttiird applet to 
EVENT IVIO SHORT IVIESSAGE CONTROL B 
Y_SIM. 

The STF shall not reply busy to a call control 
envelope 

1- An Envelope formatted SMS PP envelope is 
sent to SIM. 

Applet2 builds a DISPLAY TEXT proactive 
command. 

2- ProactiveHandler . send ( ) method is 
called. 

3- An Envelope MO Short message envelope is 
sent to SIM 

ToolkitRegistry . clearEvent {) for 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Appletl finalizes. 

ToolkitRegistry . setEvent ( ) method is 
called for 

EVENT_MO_SHORT_ME S SAGE_CONTROL_BY_S IM . 
Applet2 execution finished. 


1 - Applet2 is triggered. 
3- Appletl is triggered. 


2- A Proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 

TERMINAL RESPONSE of 
DISPLAY TEXT is sent to 
the SIM 


3 


Applets triggering 

An Envelope MO SMS control by SIM envelope 
is sent ot SIM 


Applet2 is triggered. 
(Appletl is not triggered) 
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CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.3.8 EVENT_TIMER_EXPIRATION 

Test Area Reference: FWK_APT_ETEX 



6.3.3.8.1 

Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this event 
and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive session is 
ongoing. 

CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered from this 
event. 



6.3.3.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.8.3 



Test Suite Files 

FWK_APT_ETEX_1 .scr 
FWK_APT_ETEX_1 .Java 

FWK_APT_ETEX_1 .Idr 
FWK_APT_ETEX_1 .ch 
FWK_APT_ETEX_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_TIMER_EXPIRATION and 
triggering 

Applet is registered to the 
EVENT_TIMER_EXPIRATION using the 
allocateTimer ( ) method and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_TIMER_EXPIRATION 

1- Toolkit Registry . isEventSet ( ) 
method is called. 

2- An Envelope TIMER_EXPIRATION is 
sent to the SIM. 



1- The method returns true 



2- Applet is triggered. 



Applet dereglstratlon 

Timer id=l 

Toolkit Registry. ReleaseTimer method 
is called 

1-An Envelope timer expiration is 
sent to the SIM. 



An Envelope formated sms pp envelope 
is sent to the sim 

Toolkit Registry. AllocateTimer method 
is called 



1 - Applet isn't triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-An Envelope TIMER_EXPIRATION is 
sent to the SIM. 


2- Applet is triggered 





6.3.3.8.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.9 EVENT_UNFORMATTED_SMS_CB 

Test Area Reference: FWK_APT_EUCB 

6.3.3.9.1 Conformance Requirement 

Normal Execution 

CRRNl: The applet is triggered by the EVENT_UNFORMATTED_SMS_CB once it has registered to this event 
and an Envelope Cell Broadcast DownLoad is received. 

CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_CB once it has deregistered from this 
event. 



6.3.3.9.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.9.3 



Test Suite Files 

FWK_APT_EUCB_l.scr 
FWK_APT_EUCB_l.java 
FWK_APT_EUCB_1 .Idr 
FWK_APT_EUCB_l.ch 
FWK_APT_EUCB_1 .par 

Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORMATTED_SMS_CB and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_UNFORMATTED_SMS_CB 

1- Toolkit Registry. isEventSet method is 
called. 

2- An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1- Method returns true. 

2- Applet is triggered 



Applet deregistratlon 



Toolkit Registry . ClearEvent () method is 
called for EVENT UNFORMATTED SMS CB 



1-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1 - Applet isn't triggered 
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Id 


Description 


API Expectation 


APDU Expectation 




An Envelope formatted sms pp envelope is 
sent to the sim 








event= EVENT_UNFORMATTED_SMS_CB 








Toolkit Registry . setEvent ( ) method is called 
for EVENT_UNFORMATTED_SMS_CB 








2-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 


2- Applet is triggered 





6.3.3.9.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: FWK APT EDMC 



6.3.3.10.1 



Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has registered to this 
event and an Envelope Event DownLoad MT Call is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has deregistered 
from this event. 



6.3.3.10.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EMSE_l.scr 
FWK_APT_EMSE_l.java 
FWK_APT_EMSE_l.ldr 
FWK_APT_EMSE_1 .clr 
FWK_APT_EMSE_1 .par 
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6.3.3.10.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_MT_CALL and 
triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2 - An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1- The method returns true 

2- Applet is triggered 




2 


Applet dereglstratlon 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 

An Envelope formatted sms pp envelope is 

sent to the sim 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.10.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.1 1 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: FWK_APT_EDCC 

6.3.3.11.1 Conformance Requirement 

Normal Execution 

CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
deregistered from this event. 
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6.3.3.11.2 

Test Script: 
Test Applet: 
Load Script: 
Clean-up Script: 



Test Suite Files 

FWK_APT_EDCC_1 .scr 
FWK_APT_EDCC_1 .Java 
FWK_APT_EDCC_1 .Idr 
FWK APT EDCC l.clr 



6.3.3.11.3 



Test Procedure 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_CONNECT 
ED and triggering 



Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 



1- Method returns true 

2- Applet is triggered. 



Applet dereglstratlon 

event =EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1-A call connected event dowload is sent 
to the SIM. 



An Envelope formatted sms pp envelope is 

sent to the sim 

Event = EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 



1 - Applet isn't triggered 



2- Applet is triggered 



6.3.3.1 1 .4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: FWK_APT_EDCD 
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6.3.3.12.1 



Conformance Requirement 



Normal Execution 

CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it has 
deregistered from this event. 



6.3.3.12.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EDCD_1 .scr 
FWK_APT_EDCD_1 .Java 
FWK_APT_EDCD_1 .Idr 
FWK_APT_EDCD_1 .ch 
FWK_APT_EDCD_1 .par 



6.3.3.12.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_DISCONN 
ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_D I S CONNECTED and 
to EVENT_FORMATTED SMS_PP_ENV. 



Event=EVENT_EVENT_DOWNLOAD_CALL_DISCONNECT 
ED 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 



1- Method returns true 



2- Applet is triggered. 



Applet deregistration 



Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . clearEvent method is 

called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the SIM. 

a formatted sms pp envelope is sent to the 
sim. 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DI SCONNECTED i s 



1 - Applet isn't triggered 



2- Applet is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




sent to the SIM. 







6.3.3.12.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.1 3 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: FWK APT EDLS 



6.3.3.13.1 

Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_D0WNL0AD_L0CAT10N_STATUS once it has 
deregistered from this event. 



6.3.3.13.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter FUe: 

6.3.3.13.3 



Test Suite Files 
FWK_APT_EDLS_1 .scr 
FWK_APT_EDLS_1 .Java 
FWK_APT_EDLS_1 .Idr 
FWK_APT_EDLS_1 .clr 
FWK_APT_EDLS_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_LOACTION_STA 
JUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT FORMATTED SMS PP ENV. 



Event=EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2 - An Envelope 

E VENT_EVENT_DOWNLOAD_LOCAT I ON_STATUS i S 
sent to the SIM. 



1- Method returns true 

2- Applet is triggered. 



Applet dereglstratlon 



Event=EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



l-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 

a formatted sms pp envelope is sent to the 

sim 



1 - Applet isn't triggered 



Event= 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 



2-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 



2- Applet is triggered 



6.3.3.13.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

Test Area Reference: FWK APT EDUA 



6.3.3.14.1 

Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has registered 
to this event and an Envelope Event DownLoad User Activity is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



6.3.3.14.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 
FWK_APT_EDUA_1 .scr 
FWK_APT_EDUA_1 .Java 
FWK_APT_EDUA_1 .Idr 
FWK_APT_EDUA_1 .clr 
FWK_APT_EDUA_1 .par 
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6.3.3.14.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_FORMATTED_SMS_PP_ENV . 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet dereglstration 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.14.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.15 EVENT_EVENT_DOWNLOADJDLE_SCREEN_AVAILABLE 

Test Area Reference: FWK_APT_EDIS 

6.3.3.15.1 Conformance Requirement 
Normal Execution 

CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE once it 
has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE once 
it has deregistered from this event. 

6.3.3.15.2 Test Suite Files 

Test Script: FWK_APT_EDIS_l.scr 
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Test Applet: 


FWK_APT 


.EDIS. 


.l.java 


Load Script: 


FWK_APT 


.EDIS. 


.l.ldr 


Cleanup Script: 


FWK_APT 


.EDIS. 


.l.clr 


Parameter File: 


FWK_APT 


.EDIS. 


.l.par 



6.3.3.15.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOADJDLE_SCREEN_ 
AVAILABLE and triggering 



Applet is registered to the 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 



1- Method retuns true 



2- Applet is triggered 



Applet deregistration 



Event=EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 



Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 



1-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 



1 - Applet isn't triggered 



a formatted sms pp envelope is sent to the 

sim 



Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 



2-An Envelope 

E VENT_DOWNLOAD_I D LE_S CREEN_AVAI LABLE i s 
sent to the SIM. 



2- Applet is triggered 



6.3.3.15.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: FWK_APT_EDCR 
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6.3.3.16.1 



Conformance Requirement 



Normal Execution 

CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it has 
registered to this event and Envelope Event DownLoad Card Reader Status is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it 
has deregistered from this event. 



6.3.3.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EDCR_1 .scr 
FWK_APT_EDCR_1 .Java 
FWK_APT_EDCR_1 .Idr 
FWK_APT_EDCR_1 .clr 
FWK_APT_EDCR_1 .par 



6.3.3.16.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CARD_READER 
_STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event =EVENT_EVENT_DOWNLOAD_CARD_READER_STA 

TUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 



1 - Method returns true 



2- Applet is triggered 



Applet deregistration 



Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . clearEvent method is 

called 

Perform SIM initialization with all the 
facilities supported 



1-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 



1 - Applet isn't triggered 



An Envelope formatted sms pp envelope is 
sent to the sim 

Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




2-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 


2- Applet is triggered 





6.3.3.16.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK APT EUEV 



6.3.3.17.1 
Normal Execution 



Conformance Requirement 



CRRNl: The applet is triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered from 
this event. 



6.3.3.17.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_APT_EUEN_l.scr 
FWK_APT_EUEN_l.java 
FWK_APT_EUEN_1 .Idr 
FWK_APT_EUEN_l.ch 
FWK_APT_EUEN_1 .par 
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6.3.3.17.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_UNRECOGNIZED_ENVELOPE and 
triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE and to 
EVENT_FORMMATTED_SMS_PP_ENV 

E vent= EVENT_UNRECOGNI ZED_ENVELOPE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope UNRECOGNIZED_ENVELOPE is 

sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= EVENT_UNRECOGNIZED_ENVELOPE 
Toolkit Registry . clearEvent method is 
called 

1- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 
sim 

Event = EVENT_UNRECOGNIZED_ENVELOPE 
Toolkit Registry . setEvent ( ) method is 
called 

2- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.17.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 



6.3.3.18 EVENT_STATUS_COMMAND 

Test Area Reference: FWK_APT_ESTC 

6.3.3.18.1 Conformance Requirement 

Normal Execution 

CRRNl: The applet is triggered by the EVENT_STATUS_COMMAND once it has registered to this event and a 
Status Command is received. 

CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 

6.3.3.18.2 Test Suite Files 

Test Script: FWK_APT_ESTC_l.scr 
Test Applet: FWK_APT_ESTC_1 .java 

FWK_APT_ESTC_2.java 

FWK_APT_ESTC_3.java 
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Load Script: FWK_APT_ESTC_l.ldr 
Cleanup Script: FWK_APT_ESTC_l.clr 
Parameter FUe: FWK_APT_ESTC_l.par 



6.3.3.18.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_STATUS_COMIUIAND and triggering 

Appletl is registered to 
EVENT_STATUS_COMMAND using the 
r e c^ue s t P olll nt ervsl {) commsnci. 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval ( ) command. 

Applets is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-A status command is sent to SIM 
Appletl execution is finished 
Applet2 execution is finished 


1- Appletl is triggered. 

2- Applet2 is triggered. 

3- Applet 3 is not triggered 




2 


Applet deregistration and registration of tlie 
tiiird applet to EVENT_STATUS_COMMAND. 
The STF shall not reply busy to a call control 
envelope 

1- A formatted sms pp envelope is sent to 
SIM 

Applets builds a DISPLAY TEXT. 

2- ProactiveHandler . send ( ) is called 

3- A status command is sent to SIM. 
requestPollInteval with POLL_NO_DURATION 

r t> OclJ-J.S:iU 

Appletl finalized 

requestPollInteval with POLL_NO_DDRATION 
is called Applet2 finalized 

requestPollInterval ( ) method is called. 
Applets execution finished. 


1 - Applets is triggered. 

3- Appletl is triggered. 

4- Applet2 is triggered. 


2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 

5- TERMINAL RESPONSE 
of DISPLAY TEXT is sent to 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


3 


Applets triggering 

Perform SIM initialization with all the 
facilities supported 

Status command is sent to SIM. 


Applets is triggered. 
(Appletl and Applet2 are not 
triggered) 





6.3.3.18.4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3 



6.3.4 Proactive Command Sending by tine STF 
6.3.4.1 System Proactive Commands 

Test Area Reference: FWK_PCS_SPCO 

6.3.4.1.1 Conformance Requirements 
Normal Execution 

CRRNl: When a toolkit applet changes a menu entry of its registry object, the SIM Toolkit Framework shall 
dynamically* update the menu stored in the ME during the current card session 

CRRN2: The STF shall use the data of the EFsume file when issuing the SET UP MENU proactive command. 

CRRN3: For all EVENT_EVENT_DOWNLOAD_*: When a toolkit applet changes one or more of these requested 
events of its registry object, the STF shall dynamically* update the event list stored in the ME during the current 
card session by SET UP EVENT LIST proactive command. 

*The STF shall send its system proactive connmand as soon as no proactive session is pending and all the applets 
registered to the current events have been triggered and have returned from the processToolkit method 
invocation. 

6.3.4.1.2 Test Suite Files 

Test Script: FWK_PCS_SPCO_l.scr 

Test Applet: FWK_PCS_SPCO_l .java 

Load Script: FWK_PCS_SPCO_l.ldr 

Cleanup Script: FWK_PCS_SPCO_l.cb- 

Parameter File: FWK_PCS_SPCO_l.par 



6.3.4.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Install Applet 1, Registered to the 
EVENT EVENT DOWNLOAD MT CALL and 
EVENT EVENT DOWNLOAD 
LOCATION_STATUS 

Perform SIM initialization with EVENT 

DOWNLOAD facilities supported 




setEventList proactive 
connmand 

[Event llst]= '19020003' 
or '99020003' 


2 


Trigger the applet by ENVELOPE 




1. DISPLAY TEXT 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




(SIVIS_FORMATTED_PP) command 

Clear the events and build a display text 

command 




Proactive command 

2. SET UP EVENT LIST 
Proactive command 

[CommandQualifier]= OOh 



6.3.4.1.4 Test Coverage 



CRR number 


Test case number 


N1 


see: 

chapter 6.2.9.2, CRRN1, 
chapter 6.2.9.4, CRRN3, 
chapter 6.2.9.5 CRRN4, 
chapter 6.2.9.8 CRRN1 


N2 


see: 

chapter 6.2.9.2 CRRN1, 
chapter 6.2.9.8 CRRN1 


N3 


1,2 



6.3.4.2 Interaction with GSM commands 

Test Area Reference: FWK_PCS_IGCO 

6.3.4.2.1 Conformance Requirements 

Normal Execution 

CRRNl: The STF shall process a GSM command even when a proactive command is pending (before and after the 
FETCH command until the terminal response). The STF shall answer with the SWl and SW2 described in [3] 
and [4]. 



6.3.4.2.2 Test Suite Files 



Test Script: 


FWK 


_PCS_ 


_IGCO_ 


_l.scr 


Test Applet: 


FWK 


PCS. 


JGCO. 


.l.java 


Load Script: 


FWK 


PCS. 


JGCO. 


.Lldr 


Cleanup Script: 


FWK 


PCS. 


JGCO. 


.Lclr 


Parameter File: 


FWK 


PCS. 


JGCO. 


J par 



6.3.4.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Interaction with GSM Commands after 
TERIVIINAL PROFILE in connection with FETCH 
and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

(Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 

2- SELECT MF 

3- GET RESPONSE (6 Bytes) 




1- 91xx 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




4- Failed SELECT File 

5- FETCH 

6- SELECT MF 

7- GET RESPONSE (6 Bytes) 

8- TERMINAL RESPONSE 




2- 9Fxx 

3- 91 XX 

4- 9404 

5- Proactive Command: 
SETUP MENU 

6- 9Fxx 

7- 9000 

8- 9000 


2 


interaction witli GSiVi Commands after 
ENVELOPE (IMENU SELECTION) 
in connection with FETCH and TERIUIINAL 
RESPONSE 

Menu Entry ID = 0x01 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- GET RESPONSE (6 Bytes) 

7- TERMINAL RESPONSE 




1- 9FXX 

2- 91 XX 

3- 9404 

4- Proactive Command: 
DISPLAY TEXT 

5- 9FXX 

6- 9000 

7- 9000 


3 


Interaction with GSM Commands after 
TERMINAL RESPONSE In proactive command 
session In connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- FETCH 

4- SELECT MF 

5- GET RESPONSE (6 Bytes) 

6- Failed SELECT File 

7- TERMINAL RESPONSE 

8- SELECT MF 

9- GET RESPONSE (6 Bytes) 

10- Failed SELECT File 

11- FETCH 

12- SELECT MF 

13- GET RESPONSE (6 Bytes) 

14- TERMINAL RESPONSE 




1- 9FXX 

2- 91 XX 

3- Proactive Command: 
DISPLAY TEXT 

4- 9FXX 

5- 9000 

6- 9404 

7- 9000 

8- 9FXX 

9- 91 XX 

10- 9404 

11 -Proactive Command: 
DISPLAY TEXT 

12- 9FXX 

13- 9000 

14- 9000 



6.3.4.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 



6.3.5 Exception Handling 

6.3.5.1 Hide Exceptions from the ME 

Test Area Reference: FWK_EXH_HEME 
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6.3.5.1.1 Conformance Requirements 

Normal Execution 

CRRNl : A toolkit applet may throw an exception, but this error will not be sent to the ME. 
* Because the behaviour of the SIM is not exactly defined for the above CRRN, there are no tests defined here yet. 



6.3.5.2 Interaction with IVIultiple Triggering 

Test Area Reference: FWK_EXH_IMTG 

6.3.5.2.1 Conformance Requirements 

Normal Execution: 

CRRNl : An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same event 

6.3.5.2.2 Test Suite Files 

Test Script: FWK_EXH_IMTG _1 .scr 

Test Applet: : FWK_EXH_IMTG _1 .Java 

Load Script:: FWK_EXH_IMTG_l.ldr 

Cleanup Script: FWK_EXH_IMTG_l.clr 

Parameter File: FWK_EXH_IMTG_1 .par 



6.3.5.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Load/install 2 toolkit applets registered to 
EVENT STATUS COMMAND, 
EVENT PROFILE DOWNLOAD, 
EVENT UNRECOGNISED ENVELOPE, 
EVENT EVENT DOWNLOAD MT CALL, 
EVENT UNFORMATTED SMS PR ENV, 
EVENT UNFORMATTED SMS PP UPD, 
EVENT_UNFORMATTED_SMS_CB 

appletl: Priority= 0x01, 
applet2 : Priority= 0x02, 

(i.e. appletl is triggered before applet2) 






1 


Status_Command Is sent 

Applet 1 is triggered 

Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




2 


Proflle_Download Is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




3 


Unrecognlsed_Envelope Is sent 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Applet 1 is triggered 

Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




4 


Event_Download_MT_Call Is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




5 


Unformatted_SMS_PP_Env Is sent 

Applet 1 is triggered 

Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




6 


Unformatted_SMS_PP_Upd Is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 




7 


Unformatted_SMS_CB Is sent 

Applet 1 is triggered 
Applet 2 is triggered 


Appletl : 

NullPointerException is thrown 





6.3.5.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7 



6.3.6 Framework Security Management 

Security Parameters 

The table that follows contains the security parameters that shall be used when the 03.48 security is required in the test 
cases developed in the current section. 



Parameter 


Value in hexadecimal 


KIC 


11 


KID 


11 


CNTR 


00 00 00 00 01 


Key for ciphering 


01 41 42 7F DA E8 91 A7 


Key for RC/CC/DS 


01 23 45 67 89 AB CD EF 



If a parameter is not listed explicitly in the above table, the default values of section 4.7.3.1 apply. 



6.3.6.1 Input Data 

Test Area Reference: FWK_FWS_INDA 
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6.3.6.1.1 



Conformance Requirements 



Normal Execution 

CRRNl: If the SIM receives an envelope APDU containing an SMS_DATADOWNLOAD BER TLV formatted 
according to GSM03.48, the SIM Toolkit Framework shall verify the GSM03.48 security of the SMS TPDU. 

CRRN2: The toolkit applet will only be triggered if the TAR is known and the security verified. 

Test Area Files 
FWK_FWS_INDA_1 .scr 
FWK_FWS_INDA_1 .Java 
FWK_FWS_INDA_2.java 
FWK_FWS_INDA_1 .Idr 
FWK_FWS_INDA_1 .ck 
FWK_FWS_INDA_1 .par 



6.3.6.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



6.3.6.1.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Framework checks the Cryptographic 
checksum and deciphers the data Appletl is 
loaded and Installed 

l-Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
Data = 01 


The applet is triggered. 




2 


Framework checks the Cryptographic 
checksum and deciphers the data 

Applet2 is installed 

1- Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
TAR of Applet 1 
Data = 02 

2- Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this featuresi 

No ciphering; 

No cryptographic checksum; 
No proof of receipt; 
TAR of Applet 2 
Data = 03 


This Envelope(SMS-PP) triggers 
Applet 1 

This Envelope{SMS-PP) triggers 
Applet 2 


The SIM answers to the 
Envelope with status words 
9000 

The SIM answers to the 
Envelope with status words 
9000 


3 


Envelope(SMS-PP) 03.48 formatted with wrong 
cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 
No proof of receipt; 


No applet is triggered 


The SIM answers to the 
Envelope with status words 
9000 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 332 ETSI TS 101 955 V7.4.1 (2002-03) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 




TAR of Applet 1 
Data = 04 







6.3.6.1 .4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 



6.3.6.2 Output Data 

Test Area Reference: FWK_FWS_OUDA 

6.3.6.2.1 Conformance Requirements 

Normal Execution 

CRRNl: The SIM Toolkit Framework shall secure and send the response packet. 



6.3.6.2.2 Test Area Files 



Test Script: 


FWK 


_FWS_ 


_OUDA_ 


_l-scr 


Test Applet: 


FWK 


_FWS_ 


_OUDA_ 


_l.java 


Load Script: 


FWK 


.FWS. 


.OUDA_ 


.l.ldr 


Cleanup Script: 


FWK 


.FWS. 


.OUDA_ 


.l.clr 


Parameter File: 


FWK 


.FWS. 


.OUDA_ 


.l.par 



6.3.6.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Envelope(SMS-PP) 03.48 formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report ; 
no security applied to proof of receipt 
Data in plain text = "APPLETl" 


The applet Is triggered and sends a 

"Display Text" proactive command 
with the data received in the 
Envelope. 


The SIM answers to the 

Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has no 
application data. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue a 
Display Text "APPLETl". 


2 


Envelope(SMS-PP) 03.48 formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report; 
no security applied to proof of receipt 
Data in plain text = "APPLETl" 


The applet posts application data. It 
does not call the 
ProactlveHandler.sendO method 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR Is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 9000. 


3 


Envelope(SMS-PP) 03.48 formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report; 
no security applied to proof of receipt 
Data in plain text = "TEST" 


The applet posts application data 

and calls the 

ProactlveHandler.sendO method to 
send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 








the application. 
The SIIVI answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


4 


Envelope(SMS-PP) 03.48 formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS— Deliver— Report; 
proof of receipt shall be ciphered 
Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.sendO method to 
send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


5 


Envelope(SMS-PP) 03.48 formatted 

The Terminal Profile command shall be 
issued with the facility "'9EXX' response 
code for SIM data download error" enabled 

The Envelope (SMS-PP) formatted has to be 
issued with the following features: 
No ciphering; 

Wrong Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report ; 

no security applied to proof of 

receiptData in plain text = "TEST" 


No applet is triggered 


The SIM answers to the 
Envelope with status words 
9Exx and a PoR is retrieved 
with a GetResponse 
command. The Response 
Status Code Octet shall be 
'01 ■. 



6.3.6.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5 



6.3.7 Envelope Response Posting 

6.3.7.1 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK ERP ECCN 



6.3.7.1.1 



Conformance Requirements 



Normal Execution 

CRRNl: The SIM Toolkit Framework can't reply busy when an Envelope(Call Control) is sent to the SIM. 

6.3.7.1.1 Test Area Files 

Test Script: FWK_ERP_ECCN_1 .scr 

Test Applet: FWK_ERP_ECCN_1 .Java 

FWK_ERP_ECCN_2.java 

FWK_ERP_ECCN_3.java 
Load Script: FWK_ERP_ECCN_l.ldr 
Cleanup Script: FWK_ERP_ECCN_l.ch- 
Parameter File: FWK_ERP_ECCN_1 .par 
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6.3.7.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet 1 is registered on the 
EVENT_CALL_CONTROL_BY_SIIVI, Applet2 Is 
registered and triggered on the 
EVENT_MENU_SELECTION. 








1- Applet2 invokes the method send () and no 
fetch is performed 

2- Envelope (Call Control) is sent to the 

SIM 

3- Appletl calls the method 
EnvelopeResponseHandler .postASBERTLV ( ) to 
change any incoming dialling number into 
+11 22 33 44. 


Applet2 is suspended 
Appletl is triggered. 


The SIIVI answer 9Fxx to tlie 
Envelope(Call Control) 

The dialling number is 
retrieved with a 

GetResponse cornmand. 
The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


Applet2's execution sliall continue. 






6-Delete appletl & applet2 








7-Install applet3 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet 3 is registered on both the events 
EVENT CALL CONTROL BY SIM and 
EVENT_MENU_SELECTION. 

1- Envelope Menu Selection is sent to the 
SIM. 

2- Applet3 invokes the method send () and no 
fetch is performed) 

3- Envelope (Call Control) is sent to the 

SIM 

4- Applet3 calls the method 
EnvelopeResponseHandler .postASBERTLV ( ) to 
change any incoming dialling number into 
+11 22 33 44. 

5- A Fetch command is sent to the SIM 

6- A Terminal Response command is sent to 
the SIM 


Applets is triggered on tlie 
EVENT_MENU_SELECTION 

Applets is suspended on the send() 
method 

Applets is triggered on the 
EVENT CALL CONTROL BY SI 
M. 

The AppletS's execution shall 
continue. 


The SIM answer 9Fxx to the 
Envelope{Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 



6.3.7.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_EMCN 

6.3.7.2.1 Conformance Requirements 
Normal Execution 

CRRNl: The SIM Toolkit Framework can't reply busy when an Envelope(MO-Short Message Control) is sent to 
the SIM. 

6.3.7.2.2 Test Area Files 

Test Script: FWK_ERP_EMCN_l.scr 
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Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.7.2.3 



FWK_ERP_EMCN_1 .Java 
FWK_ERP_EMCN_2.java 
FWK_ERP_EMCN_3.java 
FWK_ERP_EMCN_1 .Idr 
FWK_ERP_EMCN_1 .clr 
FWK_ERP_EMCN_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet 1 is registered on the 
EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y_SIIVI; Applet2 is registered and triggered on 
the EVENT MENU SELECTION. 



1- Applet2 invokes the method send () and no 
fetch is performed) 

2- Envelope (MO-SM control) is sent to the 

SIM 

3- Appletl calls the method 

EnvelopeResponseHandler . postASBERTLV () to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
Service Center into +11 22 33 44 



Applet2 is suspended 
Applet 1 is triggered. 



4- A Fetch command is sent to the SIM 

5- A Terminal Response command is sent to 

the SIM 



6- Delete appletl & applet2 

7- Install applets 



The Applet's execution shall 
continue. 



The SIM answers 9Fxx to 

the Envelope(MO-Short 
Message Control) 



The 

TP_Destination_Address is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet 3 is registered on both the events 
EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM and EVENT_MENU_SELECTION. 

1-Applet3 invokes the method send () and no 
fetch is performed) 


Applet 3 is suspended on the 
send() method 






2- Envelope (MO-SM control) is sent to the 

SIM 

3- Applet3 calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
Service Center into +11 22 33 44. 


Applets is triggered on the 
EVENT MO SHORT IVIESSAGE 
CONTROL_BY_SIM. 


The SIM answers 9Fxx to 

the Envelope(MO-Short 
Message Control) 

The 

TP Destination Address is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


The AppletS's execution shall 
continue. 





6.3.7.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK ERP EUEN 



6.3.7.3.1 



Conformance Requirements 



Normal Execution 

CRRNl: The EnvelopeResponseHandler is available for the EVENT_UNRECOGNIZED_ENVELOPE. 

Test Area Files 
FWK_ERP_EUEN_1 .scr 
FWK_ERP_EUEN_1 .java 
FWK_ERP_EUEN_1 .Idr 
FWK_ERP_EUEN_1 .clr 
FWK_ERP_EUEN_1 .par 



6.3.7.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 
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6.3.7.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


An applet triggered on the 
EVENT_UNRECOGNIZED_ENVELOPE calls the 
EnvelopeResponseHandler.postO method 


The post() method returns no 
exception 


The SIM answers to the 
Envelope with status words 
9Fxx. The data retrieved 
with the GetResponse 
command are the ones 
posted by the applet. 



6.3.7.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.8 Toolkit Installation 
6.3.8.1 Timers Allocation 

Test Area Reference: FWK_TIN_TMAL 



6.3.8.1.1 Conformance Requirements 
Normal execution 

CRRNl: One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit applet. 
Context errors 

CRRCl : Allocated timers shall not exceed the maximum number of timers allowed for this applet instance defined 
during installation. 

CRRC2 : The total number of timers allocated for all the applets shall not exceed 8. 

6.3.8.1.2 Test suite files 



Test Script: 


FWK 


_T1N 


TMAL_ 


_l.scr 


Test Applet: 


FWK 


_T1N_ 


_TMAL_ 


_l.java 




FWK 


_T1N_ 


_TMAL_ 


_2.java 




FWK 


.TIN 


TMAL. 


.S.java 


Load Script: 


FWK 


TIN 


TMAL. 


.l.ldr 


Cleanup Script: 


FWK 


TIN. 


TMAL. 


.l.clr 


Parameter File: 


FWK 


TIN 


.TMAL. 


.l.par 
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6.3.8.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


More than 8 timers at the 
Instantiation of appletl : check 
that appletl is not installed or 
that it is not possible to 
allocate more than 8 timers . 

Install for install of appletl with 
maximum 9 timers allocated. 

appletl is triggered: we allocate 9 timers 
appletl is selected 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 
only on the 9* allocateTimer() 


The SIIVI answers to the 
Envelope with status words 
90 00 

2 behaviours may be 

expected : 
1 . appletl is not found, 
status word 6X XX 
2. appletl has been 
installed and only 8 timers 
are allocated 




Reset the card and delete instance of appletl 






2 


Good installation of applet2 

Install for install of applet2 (maximum 4 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


3 


Allocate 4 timers 
Applet2 


No exception shall be thrown. 




4 


Allocate one more timer 
Applet2 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




5 


Good installation of applets 

Install for install of applets (maximum 8 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


6 


Allocate 4 timers 
Applets 


No exception shall be thrown. 




7 


Allocate one more timer 


Shall throw a ToolkitException with 

roncnn MCl TIMFR AVAII ARI F 




8 


Check that each timerld (allocated by applet2 
and applets) is between 1 and 8 and is different 
from each other 







6.3.8.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


2,3,8 


C1 


1,7 


C2 


4,5,6 



6.3.8.2 Item Identifier 

Test Area Reference: FWK_TIN_ITID 
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6.3.8.2.1 Conformance Requirements 
Normal execution 

CRRNl: If the requested item identifier in the range [1-127] is not already allocated, then this item identifier shall 
be allocated to the current applet. 

CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 
Parameters error 

CRRPI: If the requested item identifier is in the range [128,255], then the card shall reject the install command. 
Context errors 

CRRCl: If the requested item identifier in the range [1-127] is already allocated, then the card shall reject the install 
command. 

6.3.8.2.2 Test suite files 



Test Script: 


FWK 


.TIN 


.ITID. 


.l.scr 


Test Applet: 


FWK 


TIN 


JTID 


_l.java 




FWK 


TIN. 


.ITID 


_2.java 




FWK 


TIN 


.ITID 


_3.java 


Load Script: 


FWK 


TIN 


.ITID 


_l.ldr 


Cleanup Script: 


FWK 


TIN 


JTID 


_l.ch- 


Parameter File: 


FWK 


.TIN 


.ITID 


_l.par 



6.3.8.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Bad installation of appletl 

Install for install of appletl. The following 
parameters item Id equal to 128 

appletl is selected 




appletl is not found, status 
word 6XXX 


2 


Good installation of appletl 

Install for install of appletl. item Id = 1 for the 
first menu and 127 for the second one 

A Terminal Profile is sent to the card with only 
PROFlLE_DOWNLOAD, 
SMS_PP_DOWNLOAD, MENU_SELECT10N, 




The SIM answers to the 
Envelope with status words 
91xx to send back to the 
ME the 2 new menus. 

The menus are 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




SET_UP_MENU and COMMAND_RESULT 
facilities. 




(position/itemld/text) 

01/01/menull 

02/127/menul2 


3 


Bad installation of apple t2 
Item identifier already allocated 

Install for install of applet2. 
item Id = 127 

applet2 is selected 




applet2 is not found, status 
word 6X XX 


4 


Good installation of applet2 

Install for install of applet2. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the 
ME the 3 menus. 

The menus are 
01/01/menull 
02/127/menul2 
03/128/menu21 


5 


Good installation of applets 

Install for install of applets, 
item Id = 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the 
ME the 4 menus. 

The menus are 

01/01/menull 

02/127/menul2 

03/128/menu21 

04/129/menu31 


6 


Good delete and installation of applet2 




The SIM answers to the 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Delete instance of applet2 




Terminal Profile with status 
words 91 XX to send back to 
the ME the 3 menus. 




Perform a RESET and a Terminal Profile with the 
facilities of PROFILE_DOWNLOAD, SMS- 
PP_DATA_DOWNLOAD, 
MENU_SELECTION, COMMAND_RESULT 
and SET_UP_MENU 




The menus are 
01/01/menull 
02/127/menul2 
03/129/menu31 




Install for install of applet2. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the 
ME the 4 menus. 

The menus are 
01/01/menull 

02/127/menul2 
03/128/menu21 
04/129/menu31 



6.3.8.2.4 Test Coverage 



CRR number 


Test case number 


Nl 


2 
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CRR number 


Test case number 


N2 


4,5,6 


PI 


1 


CI 


3 



6.3.8.3 Item Position 

Test Area Reference: FWK TIN ITPO 



6.3.8.3.1 



Conformance Requirements 



Normal execution 

CRRNl : The position of the new menu entries is an absolute position among the existing ones. 
CRRN2: If the position identifier is OOh, the menu shall have the last position 

6.3.8.3.2 Test suite files 

Test Script: FWK_TIN_ITPO_l.scr 
Test Applet: FWK_TIN_ ITPO _1. Java 

FWK_TIN_ rrPO _2.java 

FWK_T1N_ ITPO _3.java 
Load Script: FWK_TIN_ ITPO _l.ldr 

Cleanup Script: FWK_TIN_ ITPO _1 .clr 
Parameter File: FWK_TIN_ ITPO _1 .par 



6.3.8.3.3 



Test Procedure 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of appletl 

Perform Install for install of 
appletl .Position/Itemid 
01/01 
02/02 

A Terminal Profile is sent to the card 




The menus are 
(position/item Id/text) 
01/01/menu11 
02/02/menu12 


2 


Installation of applet2 

Perform Install for install of applet2. 

Position/Itemid 

03/03 

04/04 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus. 

The menus are 

(position/itemld/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 


3 


Installation of applet3 

Perform Install for install of applet3. 

Position/Itemid 

00/05 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 5 menus. 

The menus are 

(position/itemld/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 

05/05/menu31 



6.3.8.3.4 Test Coverage 



Note : As Item Position management is not fully specified in the [7] or [8] all possible tests cannot be performed. 



CRR number 


Test case number 


N1 


1,2 


N2 


3 



6.3.8.4 Maximum Text Length for a menu entry 

Test Area Reference: FWK_TIN_MLME 



6.3.8.4.1 Conformance Requirements 
Normal execution 

CRRNl: The maximum length of item text string is defined at the installation of the toolkit applet. 
Parameters errors 

CRRPl: If initMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a menu 
entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 

CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 
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6.3.8.4.2 Test suite files 

Test Script: FWK_TIN_MLME_l.scr 
Test Applet: FWK_TIN_MLME_1 .Java 

Load Script: FWK_TIN_MLME_l.ldr 
Cleanup Script: FWK_TIN_MLME_1 .cir 
Parameter File: FWK_TIN_MLME_1 .par 



6.3.8.4.3 Test Procedure 



Id 


Description 


API / Framework Expectation 


APDU Expectation 


1 


Installation of applet with 2 menus not 
exceeding the maxirnum text length 

Install one applet with 2 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl " , "MenuEntry2" 

Offset = 

Length = 10 

NextAction = '00' 

HelpSupported = false 

IconQualifier = '00' 

Iconldentif ier = 






2 


InitMenuEntry with a too large length 

InitMenuEntry with length equal to 11 
MenuEntry = " MenuEntry03" 

Offset = 
Length = 11 
NextAction = '00' 
HelpSupported = false 
IconQualifier - '00' 
Iconldentif ier = 


ToolkitExcGption 

ALLOWED_LENGTH_EXCEEDED 
is thrown 




3 


InltiUlenuEntry with a right length 

initMenuEntry with length parameter equal 

to 10 

MenuEntry = " MenuEntry 3" 
Offset = 
Length = 10 
NextAction = '00' 
HelpSupported = false 
IconQualifier = '00' 
Iconldentif ier = 




a SET UP MENU (2 items) 
Is issued with TLV item 
length equal to 11 (Identifier 
+ Text string of Item) 


4 


changeMenuEntry with a right length 

Appletl is triggered by a 
EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 
parameter equal to 10 
Id = '01' 

MenuEntry = "MenuEntry 4" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualifier = 
Iconldentif ier = 

Return from processToolkit 




a SET UP MENU (2 items) 
is issued with TLV item 
length equal to 11 (Identifier 
+ Text string of Item) 


5 


ChangeMenuEntry with a too large length 

Appletl is triggered by a 
EVENT_MENU_SELECTION . 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is ttirown 


Shall not receive a SET UP 
MENU different from the 
previous one 
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Id 


Description 


API / Framework Expectation 


APDU Expectation 




ChangeMenuEntry of menu 1, with length 
parameter equal to 11 
Id = '02' 

MenuEntry = "MenuEntryOS" 

Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

Return from processToolkit 







6.3.8.4.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1,3,4 


CRRP1 


2 


CRRP2 


5 



6.3.8.5 Maximum number of menu entries 

Test Area Reference: FWK_TIN_NBME 

6.3.8.5.1 Conformance Requirements 
Normal execution 

CRRNl: The maximum number of menu entries is defined at the installation of the toolkit applet and can be the 
maximum number of successful invocations of the method initMenuEntry . 

Parameters errors 

CRRPl: If the menu entry cannot be initialised (e.g. no more item data in applet loading parameter), a 
ToolldtException with the REGISTRY_ERROR reason code is thrown. 

6.3.8.5.2 Test suite files 

Test Script: FWK_TIN_NBME_l.scr 
Test Applet: FWK_TIN_NBME_l.java 
FWK_TIN_NBME_2.java 
Load Script: FWK_TIN_NBME_l.ldr 
Cleanup Script: FWK_TIN_NBME_l.clr 
Parameter File: FWK_TIN_NBME_l.par 

6.3.8.5.3 Test Procedure 



id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is ^3', defined at the 
install (install) command. 

InitMenuEntry for each menu entry allowed 
(3 times) 

MenuEntry = "menul", "menu2", "menu3" 

Offset = 
Length = 5 


No Exception is tlirown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 






2 


lnltofa4"menu 

initMenuEntry one more time 
MenuEntiry = "menu4" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


SET UP IVIENU (3 items) is 
issued with TLV item length 
equal to 6 (Identifier + Text 
string of item) 


3 


Installation of 2"^* applet with menu 

Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

initMenuEntry once 
MenuEntry = "menul" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


Shall not receive a SET UP 
MENU different from the 
previous one 



6.3.8.5.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2,3 



6.3.8.6 Access Domain 

Test Area Reference: FWK_TIN_ACDO 

6.3.8.6.1 Conformance Requirements 
Normal execution 

CRRNl: The Access Domain parameter indicates the mechanism used to control the applet instance access to the 
GSM file System ('00' means full access to the GSM File System, 'FF' means no access to the GSM File System). 

Parameters errors 

CRRPl: If the Access Domain Parameter requested is not supported, the card shall return the Status Word '6A80', 
incorrect parameters in data field, to the Install(Install) command. 

CRRP2: If an applet with Access Domain Parameter 'FF' (i.e. No Access to the GSM File System) tries to access a 
GSM file (e.g. invoke the updateBinary(..) method) the framework shall throw a SIMViewException with a 
AC_NOT_FULFILLED reason. 

6.3.8.6.2 Test suite files 

Test Script: FWK_TE^_ACDO_I.scr 
Test Applet: FWK_TIN_ACDO_l .Java 

FWK_TIN_ACD0_2.java 
FWK_TIN_ACD0_3 .j ava 
Load Script: FWK_TIN_ACDO_I.ldr 
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Cleanup Script: FWK_TIN_ACDO_l.clr 
Parameter File: FWK_TIN_ACDO_l .par 



6.3.8.6.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Install (install) appletl with: 

- Length of Access Domain field value is 
~1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 

Install (install) applet2 with: 

- Length of Access Domain field value is 
~1' 

- Access Domain Parameter value is 'FF' 
(No access to the GSM File System) 

Install (install) applets with: 

- Length of Access Domain field value is 
-1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 






1 


readBinary/readRecord method with full 
Access Domain Parameter 

1- Select EF-TARU file whose Read access 
condition is ALWAYS 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

2- Select EF-SMS file whose Read access 
condition is CHVl 

Perform the readRecord method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

3- Select EF-TRAC file whose Read access 
condition is CHV2 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Read access 
condition is ADMO 

Perform the readBinary method: 
fileOffset = 
resp = abRead [ ] 
respOffset = 
respLength = 3 

5- Select EF-TNR file whose Read access 
condition is NEVER 

Perform the readBinary method: 
fileOffset = 
resp = abRead [] 
respOffset = 
respLength = 3 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




2 


updateBlnary/updateRecord method with full 
Access Domain Parameter 


1 to 4- no exception is thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



For each case, send an Envelope that 
triggers the applet with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

1- Select EF-TNR file whose Update access 
condition is ALWAYS 

Perform the updateBinary method: 

fileOffset = 

resp = abUpdate [FFFFFF] 

respOffset = 

respLength = 3 

2- Select EF-SMS file whose Update access 
condition is CHVl 

Perform the updateRecord method: 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = Oresp = abUpdate [ ] 
respOffset = 
respLength = 3 

3- Select EF-FDN file whose Update access 
condition is CHV2 

Perform the updateBinary method: 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Update access 
condition is ADMO 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

5- Select EF-TNU file whose Update access 
condition is NEVER 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 



5- SIMViewException 

AC NOT FULFILLED is thrown 



invalidate method with full Access Domain 
Parameter 



1- Select EF-TNR file whose Invalidate 
access condition is ALWAYS 

Perform the invalidate method 

2- Select EF-TIAC file whose Invalidate 
access condition is CHVl 

Perform the invalidate method 

3- Select EF-ADN file whose Invalidate 
access condition is CHV2 

Perform the invalidate method 

4- Select EF-SUME file Invalidate access 
condition is ADMO 

Perform the invalidate method 

5- Select EF-CNIV file whose Invalidate 
access condition is NEVER 

Perform the invalidate method 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is tlirown 



rehabilitate method with full Access Domain 
Parameter 



Select EF-TNR file whose Rehabilitate 
- - " - A" "A"" 



1 to 4- no exception is thrown 



5- SIMViewException 

AC NOT FULFILLED is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




access condition is ALWAYS 
Perform the rehabilitate method 

2- Select EF-IMSI file whose Rehabilitate 
access condition is CHVl 

Perform the rehabilitate method 

3- Select EF-ADN file whose Rehabilitate 
access condition is CHV2 

Perform the rehabilitate method 

4- Select EF-SUME file Rehabilitate access 
condition is ADMO 

Perform the rehabilitate method 

5- Select EF-CNRI file whose Rehabilitate 
access condition is NEVER 

Perform the rehabilitate method 






5 


Increase method with full Access Domain 
Parameter 

1- Select EF-CNU file whose Increase 
access condition is ALWAYS 
Perform the increase method: 

incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

2- Select EF-ACM file whose Increase 
access condition is CHVl 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

3- Select EF-CIAC file whose Increase 
access condition is CHV2 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

4- Select EF-CIAA file Increase access 
condition is ADMO 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

5- Select EF-CNR file whose Increase 
access condition is NEVER 

Perform the increase method 

Appletl finalizes 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




6 


readBlnary method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-TARU file whose Read access 

condition is ALWAYS 

Perform the readBlnary method: 

fileOffset = 

resp = abRead[] 

respOffset = 

respLength = 3 

t 


SIIVIViewException 
AC_NOT_FULFILLED is tlirown 




7 


updateRecord method with no Access Domain 


SIIVIViewException 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SMS file whose Update access 

condition is CHVl 

Perform the updateRecord method: 

fileOffset = 

resp = abUpdate[] 

respOffset = 

respLength = 3 


AC_NOT_FULFILLED is thrown 




8 


invalidate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-ADN file whose Invalidate access 

condition is CHV2 

Perform the invalidate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




9 


rehabilitate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SUME file Rehabilitate access 

condition is ADMO 

Perform the rehabilitate method 


SIIVIViewException 
AC_NOT_FULFILLED is thrown 




10 


Increase method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-CNR file whose Increase access 

condition is NEVER 

Perform the increase method 

Applet2 finalizes 

Applets restore EF-SUME 


SIIVIViewException 
AC_NOT_FULFILLED is thrown 





6.3.8.6.4 Test Coverage 



Note : As Item Position management is not fully specified in the [7] or [8] all possible tests catmot be performed. 



CRR number 


Test case number 


CRRN1 


1, 2, 3, 4, 5 


CRRP1 


Not tested 


CRRP2 


6, 7, 8, 9,10 



6.3.8.7 Priority Level 

Test Area Reference: FWK_TIN_PRLV 
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6.3.8.7.1 Conformance Requirements 
Normal execution 

CRRNl: The priority specifies the order of activation of an applet compared to the other applet registered to the 
same event ('01' : Highest priority level, 'FF' : Lowest priority level) 

CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets are 
activated according to their installation date (i.e. the most recent applet is activated first) 

6.3.8.7.2 Test suite files 

Test Script: FWK_TIN_PRLV_x.scr, x from 1 to 12 

Test Applet: FWK_TIN_PRLV_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB 

Load Script: FWK_TIN_PRLV_x.ldr, x from 1 to 12 

Cleanup Script: FWK_TIN_PRLV_x.ck, x from 1 to 12 

Parameter File: FWK_TIN_PRLV_x.par, x from 1 to 12, , 8A, SB, 9A, 9B, lOA, lOB 

6.3.8.7.3 Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



All applets are registered on an 
EVENT UNFORMATTED SMS PP ENV event 



Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level ^2' and applet2 with priority level 
"1', from package fwk_tin_prlv_l . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 



A static variable is used to validate 

triggering order: applet2 is 
triggered before appletl 



Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level '1' and applet2 with priority level 
"2', from package fwk_tin_prlv_2 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 



Delete applets instances and packages 



A static variable is used to validate 
triggering order: appletl is 
triggered before applet2. 



Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '80' and applet2 with priority level 
'7F', from package fwk_tin j>rlv_3 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 



A static variable is used to validate 

triggering order: applet2 is 
triggered before appletl 
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4 


Trigger 2 appiets witli 2 different Priority 
Leveis 

Install (install) appletl with priority 
level ^7F' and applet2 with priority level 
'80', from package fwk_tin_prlv_4 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




5 


Trigger 3 appiets witti ttie same Priority Levei 

Install (install) applet 1, 2, 3 in this 
order with same priority level from 
package f wk_tin_prlv_5 . 

Send an Envelope that triggers the 3 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages. 


A static variable is used to validate 
triggering order: applets is 
triggered before applet2, and 
applet2 is triggered before appletl . 




6 


Trigger 2 appiets from 2 classes, with 2 
different Priority Levei 

Install (install) appletl from class A 
with priority level '2' 
Install (install) applet2 from class B 
with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




7 


Trigger 2 appiets from 2 classes, with the same 
Priority Level 

Install (install) appletl from class A 
with priority level '1' 

Install (install) applet2 from class B 
with priority level '1' 

Send an Envelope that triggers the 2 

applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

Install package fwk_tin_prlv_8 . 
Install (install) appletl from package 
f wk_tin_prlv_8A with priority level '2' 
Install (install) applet2 from package 
f wk_tin_prlv_8B with priority level '1' 
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Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances ad packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




9 


Trigger 2 appiets from 2 pacl<ages, with the 
same Priority Levei 

Install package fwk_tin_prlv_9 . 
Install (install) applets 1 from package 
fwk_tin_prlv_9A and applet2 from package 
f wk_tin_prlv_9B in this order, with same 
priority level 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




10 


Trigger 4 appiets from 2 paclcages 

1- Install packages fwk_tin_prlv_10, 
fwk_tin_prlv_10A and fwk_tin_prlv_10B . 
Install (install) 2 applets 1 then 2 from 
package fwk_tin_prlv_10A, with 
respectively priority levels 1 and 2. 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

2- Install (install) 2 applets 3 then 4 
from package fwk_tin_prlv_10B, with 
respectively priority levels 1 and 2. 

Send an Envelope that triggers the 4 
applets . 

Delete applets instances and packages 


1 - A static variable is used to 
validate triggering order: appletl is 
triggered before applet2 

2- Applets is triggered before 
applets 1 , 4, tfien 2. 




11 


Trigger 4 appiets with the same Priority Levei 
then deiete them one after another and trigger 
them each time 

1- Install (install) appletl, 2, 3, 4 in 
this order with same priority level from 
package fwk_tin_prlv_ll . 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applet instance 4 

2- Send an Enveloppe that triggers the 3 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applet instance 3 

3- Send an Enveloppe that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 


1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3, 2, 1 . 

2- Applets are triggered in order 3, 
2, 1. 
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Delete remaining applet instances and 
packages 


3- Applets are triggered in order 2, 
1. 




12 


Trigger 5 applets with different Priority Levels, 
alternating Install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

2- Delete applet instance 1 and install 
(install) applets with priority level 2 

Send an Enveloppe that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

3- Re-install (install) appletl with 
priority level 1 

Send an Enveloppe that triggers the 5 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 


1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 

2- Applets are triggered in order 3, 
5, 4, 2 

3- Applets are triggered in order 1 , 
3, 5, 4, 2 





6.3.8.7.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1,2, 3, 4, 6, 8, 10, 12 


CRRN2 


5, 7, 9, 11 



6.3.9 File System Context 
6.3.9.1 Initial Context 

Test Area Reference: FWK_FSC_INIT 

6.3.9.1.1 Conformance Requirements 
Normal Execution 

CRRNl: At the invocation of the processToolkit method of a toolkit applet, the current file is the MF. 

6.3.9.1.2 Test Suite Files 

Test Script: FWK_FSC_INIT_l.scr 
Test Applet: FWK_FSC_INrr_l .Java 
FWK_FSC_INrr_2.java 
Load Script: FWK_FSC_INIT_l.ldr 
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Cleanup Script: FWK_FSC_INIT_l.clr 
FWK_FSC_INIT_2.clr 
Parameter File: FWK_FSC_INIT_1 .par 



6.3.9.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


MF is the selected DF in processToolkit() 

An ENVELOPE APDU containing a formatted 
SMS PP for Applet 1 is issued to the SIM 
byte[] fci = new byte [10] 
fciOffset = 
fclLength = 7 
status ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 




2 


No EF is selected 

rehabilitate () 


SIMView exception shall be thrown 
with reason NO EF SELECTED 




3 


MF is selected even when an applet triggered 
before selected any other file... 

Applets 1 and 2 register to 

V ILiN ± U W v'l L'l lj\JnL/ U OILr\ ± ± V ± ± 1 . rtppx c L_ J. lid o 

higher priority than Applet 2 . 

An ENVELOPE "EVENT - USER ACTIVITY" is 
sent to the SIM 

1 - Applet 1: 

- is triggered by 

event_event_download_user_act ivity 

- selects DF_GSM and EF_IMSI 

2 - Applet 2: 

- is triggered by 

event„event_download_user_act ivity 
fciOffset = 
fclLength = 7 
status ( ) 

3 - rehabilitate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 

3 - SIMView exception shall be 
thrown with reason 
NO_EF_SELECTED 





6.3.9.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 



6.3.9.2 Context Preservation (current file) 

Test Area Reference: FWK_FSC_CUn 

6.3.9.2.1 Conformance Requirements 

Normal execution 

CRRNl: When calling the method select (), the current files (file context) of any other applets shall not be changed 
(see GSM 03.19 [] - §5.2). 

CRRN2: The select() methods select a file without changing the current file of any other applet or of the subscriber 
session. 

CRRN3: After invocation of ProactiveHandler.send() method: the current file context of the toolkit applet is 
unchanged (see GSM 03.19 [] - §5.2.). 
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6.3.9.2.2 Test Suite Files 



1 CM OHIJJI. 


1 V V IX 1 k J V 


riTFT 


_1 .scr 




-T w -iv_rov_._ 


r'TTPT 


_1 .Java 




FWK_FSC. 


.CUFT. 


.2 .Java 


Load Script: 


FWK_FSC 


_CUFI_ 


_l.ldr 


Cleanup Script: 


FWK_FSC_ 


_CUFI_ 


_l.clr 




FWK_FSC 


.CUFI. 


2.clr 


Parameter File: 


FWK_FSC 


.CUFI. 


.l.par 



6.3.9.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No change to file context by another applet 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV . 
Applet2 registers to 
EVENT_CALL_CONTROL_BY_S IM 

1 - Applet 1: 

- is triggered by a formatted SMS 

- selects DF_SIMTEST and EF_TARU 

- fileOffset = 0; dataLength = 2; 
dataOffset = 0; 

- buffer = (OxCA, OxFE } 

- updateBinary () : first 2 bytes of 
EF_TARU are written as 'CA EE' . 

- issues SL proactive conunand "Get Inkey". 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 

- selects DF_TELECOM and EF_ADN . 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


A GET INKEY proactive 
command is fetched from 
the SIM 


2 


No change to file context by subscriber 
session 

1 - Applet 1 

- issues a proactive command "Get Inkey". 

2 - Subscriber session selects DF_TELECOM 
and EF_ADN. 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


No change by applet of subscriber session 
context 

1 - Applet 1: 

- selects DF_SIMTEST and EF_TND 

- issues a proactive command "Get Inkey". 

2 - subscriber session reads record 1 of 
current file (shall be EF_ADN) 

3 - The terminal response for Get Inkey 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 

2 - READ RECORD 

absolute number 1 shall 
read "FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




reactivates Applet 1, which terminates 
execution 




FF FF FF FF FF FF" (from 
EFadn) 



6.3.9.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1,2,3 


CRRN3 


1,2 



6.3.9.3 Context Preservation (current record pointer) 

Test Area Reference: FWK FSC CURE 



6.3.9.3.1 



Conformance Requirements 



Normal execution 

CRRNl: When the seek method is called by one applet, the record pointer of any other applet is not changed. 

CRRN2: updateRecord: the current record pointer of other applets / subscriber shall not be changed in case of Unear 
fixed EF 

CRRN3: updateRecord: the record pointer of a cyclic EF shall be changed for all other applets / subscriber to the 
record number 1. 

CRRN4: readRecord: read data bytes of the linear fixed or cyclic EF currently selected by the applet without 
changing the current record pointer of any other applet / subscriber. 

CRRN5: increase: the last updated record of the cyclic EF currently selected becomes record number 1 for every 
other applet and subscriber session. 

6.3.9.3.2 Test Suite Fiies 

Test Script: FWK_FSC_CURE_l.scr 
Test Applet: FWK_FSC_CURE_1 .Java 

FWK_FSC_CURE_2.j ava 
Load Script: FWK_FSC_CURE_l.ldr 
Cleanup Script: FWK_FSC_CURE_l.clr 

FWK_FSC_CURE_2.clr 
Parameter File: FWK_FSC_CURE_1 .par 



6.3.9.3.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Seel< without affecting another record pointer 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV 
Applet 2 registers to 
EVENT_CALL_CONTROL_BY_S IM 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 


1 - No exception sliall be thrown. 

2 - No exception sliall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL event 

- selects DF_SIMTEST and EF_LARU 

- performs a seek of pattern {0x55} from 
beginning forward, which finds record 1 . 

- returns from processToolkit 

3 - The terminal response for Get Inkey 

reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 






2 


updateRecord in linear fixed EF without 
affecting current pointer of others 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- updates record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


readRecord In linear fixed EF without affecting 
current pointer of others 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL BY SIM 

event 

- selects DF_SIMTEST and EF_LARU 

- reads record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 
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CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


not tested (see Note) 


CRRN4 


3 


CRRN5 


not tested (see Note) 



Note: These requirements have not been tested because of an inconsistent behavior in 03.19, which is foreseen to be 
corrected in future releases. 

6.3.10 Other parts transferred to framework from API 
6.3.1 0.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: FWK_API_HEPO 

6.3.10.1.1 Conformance Requirement: 

Normal execution 

CRRNl : The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment 

(JCRE) Specification [12]). 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment 
(JCRE) Specification [12]). 

CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

Parameters error 

Context errors 



6.3.10.1.2 Test suite files 



Test Script: 


FWK 


_AP1_ 


_HEPO_ 


_l.scr 


Test Applet: 


FWK 


_AP1_ 


_HEPO_ 


_l.java 


Load Script: 


FWK 


.API. 


.UEPO. 


.l.ldr 


Cleanup Script: 


FWK 


.APT 


.HEPO. 


.l.ch- 


Parameter File: 


FWK 


.APT 


.HEPO. 


.l.par 



6.3.10.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


EnvelopeHandler.getTheHandler and store it in 
a static field of the tooll<it applet 


SecurityException is thrown 




2 


EnvelopeHandler.getTheHandler and store it in 
a field of the toolkit applet 


SecurityException is thrown 




3 


EnvelopeResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 




4 


EnvelopeResponseHandlergetTheHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 
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5 


ProactiveHandler.getTheHandler and store it In 
a static field of the toolkit applet 


SecurityException is thrown 




6 


ProactiveHandler.getTheHandler and store it in 
a Tieiu OT ine iooikii appiei 


SecurityException is thrown 




7 


Build and send a DISPLAY TEXT command to 

l%A aI^Ia #A #Va4 tl^A ■■AfAI'AnAA Af tl^A 

De auie lo gei ine reierence ot ine 
ProactiveReponseHandier 

ProactiveResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 


rroaciive comrnana reicneo 
and terminal response is 
issued 


8 


ProactiveResponseHandler.getTheHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 





6.3.1 0.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


3,4 


N3 


5,6 


N4 


7,8 



6.3.10.2 Transaction 

Test Area Reference: FWK_API_TRAN 

6.3.10.2.1 Conformance Requirement: 

Normal execution 

CRRNl: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted.. 



6.3.10.2.2 Test suite files 



Test Script: 


FWK 


.API. 


TRAN. 


.l.scr 


Test Applet: 


FWK 


.API. 


TRAN. 


.l.java 


Load Script: 


FWK 


.API. 


TRAN. 


.l.ldr 


Cleanup Script: 


FWK 


.API. 


TRAN. 


.l.ch 


Parameter File: 


FWK 


.API. 


.TRAN. 


.l.par 



6.3.10.2.3 Test Procedure 



id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Verify that transaction is aborted when a 
proactive command is sent 

Initialise a byte field with 0x05 

Build a display text proactive command. 

beginlransactionO 

Update the byte with 0x02 

send the proactive command 

Verify that the byte value is 0x05 
JCSystem.getTransactionDepthO 


Shall return 


Proactive command fetched 
and terminal response is 
issued 
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CRR number 


Test case number 


N1 


1 



6.3.10.3 Timer Id between Applets 

Test Area Reference: FWK_API_TMID 

6.3.10.3.1 Conformance Requirement: 

Context errors 

CRRCl: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with INVALID_TIMER_ID 
reason if the timer is vaUd but isn't allocated to this applet. 



6.3.10.3.2 Test suite files 



Test Script: 


FWK 


_APT 


TMID_ 


_l.scr 


Test Applet: 


FWK 


_API_ 


_TMID_ 


_l.java 


Load Script: 


FWK 


_API_ 


_TMID_ 


_l.ldr 


Cleanup Script: 


FWK 


.API. 


.TMID_ 


.l.clr 


Parameter File: 


FWK 


.API. 


TMID_ 


.Ipar 



6.3.10.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


During installation : 
First instance allocate a timer and store the 
returned value In a static field. 
Second instance allocate a timer. 
Trig second instance and try to releaseTimer() 
with the static field value. 


reieaseTlmerO shall throw a 

ToolkitException with 
INVALID_TIMERJD reason 





6.3.1 0.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1 
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Annex A (normative): 

Class and Methods AID numbering and acronyms 



A.1 Sim. access 



Class Name 


Acronyms 


Numbering on 5 bits 


SIMView 


svw 


00001 


SIMSystem 


SSY 


00010 


SIMViewException 


SVE 


00011 


A.1.1 SIMView methods 


Method Name 


Acronyms 


Numbering on 6 bits 


static final Constants 




000001 


short increase (byte [ ] incr, short incrOffset, byte[] 
reap, short respOffset) 


INCR_BS_BS 


000010 


void invalidate 


INVL 


00001 1 


void readBinary (short fileOffset, byte[] resp, short 
respOffset, short respLength) 


REDBS_BSS 


000100 


short readRecord ( short recNumber, byte mode, short 

recOffset, b\'ten reso, short respOffset, short 
respLength) 


REDRSBS_BSS 


000101 


void rehabilitate ( ) 


REHA 


000110 


short seek (byte mode, byte[] patt, short pattOffset, 
short pattLength) 


SEEKB_BSS 


000111 


void select (short fid) 


SLCTS 


001000 


short select (short fid, byte [ ] fci, short fciOffset, 

short fciLength) 


SLCTS_BSS 


001001 


short status (byte [ ] fci, short fciOffset, short 

fciLength) 


STAT_BSS 


001010 


short updateBinary ( short fileOffset, byte [ ] data, 
short dataOffset, short dataLength) 


UPDBS_BSS 


001011 


void updateRecord ( short recNumber, byte mode, short 
recOffset, byte[] data, short dataOffset, short 
dataLength) 


UPDRSBS_BSS 


001100 



A.1 .2 SllVISystem methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static SIMView getXheSIMView () 


GETS 


000001 



A.1. 3 SIMViewException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THITS 


000001 


SIMViewException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 
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A.2 Sim.toolkit 



Class Name 


Acronyms 


Numbering on 5 bits 


Toolkit Constants 


TKC 


00001 


Toolkitlnterface 


TKI 


00010 


EditHandler 


EDH 


00011 


EnvelopeHandler 


ENH 


00100 


EnvelopeResponseHandler 


ERH 


00101 


MEProf ile 


MEP 


00110 


ProactiveHandler 


PAH 


00111 


ProactiveResponseHandler 


PRH 


01000 


ToolkitRegistry 


TKR 


01001 


ViewHandler 


VWH 


01010 


Toolkit Except ion 


TKE 


01011 



A.2.1 ToolkitConstants 



Method Name 


Acronyms 


Numbering on 6 bits 


Constants 


CONS 


000001 



A.2. 2 Toolkitlnterface methods 



Method Name 


Acronyms 


Numbering on 6 bits 


void processToolkit (byte event) 


PRTKB 


000001 



A.2.3 EditHandler methods 

The numbering of the EditHandler methods it will be done in the classes inherit it: EnvelopeResponseHandler, 
ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2. 4 EnvelopeHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


byte getEnvelopeTag ( ) 


GENT 


000001 


byte getltemldentif ier ( ) 


GIID 


000010 


short getSecuredDataLength ( ) 


GSDL 


000011 


short getSecuredDataOf f set ( ) 


GSDO 


000100 


EnvelopeHandler getTheHandler ( ) 


GTHD 


000101 


short getTPUDLOf f set ( ) 


GTPO 


000110 








Inherited Method Name: ViewHandler 






Byte 

compareValue ( short valueOff set , byte [ ] compareBuf fer, 
short compareOf f set , short compareLength) 


CPRVS_BSS 


000111 


Short 

copy (byte [] dstBuf fer, short dstOff set, short dstLengt 
h) 


GOPY_BSS 


001000 


Short 

copyValue (short valueOffset, 

byte[] dstBuf fer, short dstOff set , short dstLength) 


CPYVS_BSS 


001001 


Byte 

f indAndCompareValue (byte tag, byte [] compareBuf fer, sh 
ort compareOf f set ) 


FAGRB_BS 


001010 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set, byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FACRBBS_BSS 


001011 


Short 

FindAndCopyValue (byte tag, byte occurence, short value 


FAGYBBS_BSS 


001100 
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Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 






Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYB_BS 


001101 


Byte 

FindTLV(byte tag, byte occurrence) 


1 — 1 K 1 1~\ n n 

FINDBB 


001 110 


Short 

GetLength 


GLEN 


001111 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010000 


Short 
GetValueLength 


GVLE 


010001 



A.2.5 EnvelopeResponseHandler methods 



Method Name 


Acronym 


Numbering on 6 bits 


EnvelopeResponseHandler getTheHandler ( ) 


GTHD 


000001 


Void post (byte statusType) 


POSTB 


000010 


Void postAsBERTLV (byte statusType, byte tag) 


POSTBB 


000011 








InhoritoH MothnH Msimo" PHitl-lsanHlor 
iiiiiciiicu iviciiiuu i^diiic Eui iridi luici 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


000100 


Void appendTLV (byte tag, byte value) 


A m~i n n 

APTLBB 


000101 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


000110 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


0001 1 1 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBB_BSS 


001000 


Void clear 


GLER 


001001 








Inhpritpd Mpthod Namp' VipwHandlpr 






Byte 

short compareOf f set , short compareLength) 


CPRVS_BSS 


001010 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLengt 
h) 


r^PlDV RCC 

L/vJr YBoo 


nm (Mi 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


CPYVS_BSS 


001100 


Byte 

FindAndCompareValue (byte tag, byte [] compareBuf f er, sh 
ort compareOf f set ) 


FAGRB_BS 


001101 


Byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FACRBBS_BSS 


001110 


Short 

FindAndCopyValue (byte tag, byte occurence, short value 
Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FAGYBBS_BSS 


001111 


Short 

f IndAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYB_BS 


010000 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010001 


Short 

GetLength 


GLEN 


010010 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010011 


Short 
GetValueLength 


GVLE 


010100 
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A.2.6 MEProfile methods 



Method Name 


Acronym 


Numbering on 6 bits 


static boolean check (byte index) 


CHECB 


000001 


Static boolean check (byte [] mask, short offset, short 
length) 


CHECBSS 


000010 


A.2.7 ProactiveHandler methods 


Method Name 


Acronyms 


Numbering on 6 bits 


GetTheHandler 


GTHD 


000001 


Init (byte type, byte qualifier, byte dstDevice) 


INITBBB 


000010 


InitDisplayText (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


INDTBB_BSS 


00001 1 


InitGet Inkey (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length) 


INGKBB_BSS 


000100 


InitGetlnput (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length, short minRespLength, 
short maxRespLength) 


INGPBB_BSSSS 


000101 


Byte sendO 


SEND 


000110 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


0001 1 1 


Void appendTLV (byte tag, byte value) 


APTLBB 


001000 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


001001 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


001010 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBB_BSS 


001011 


Void clear 


CLER 


001100 








Inherited Method Name: ViewHandler 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, s 
hort compareOf f set , short compareLength) 


OrriVbBbo 


AA^ HAH 

001 101 


Short 

Copy (byte [] dstBuf fer, short dstOff set, short dstLength 
J 


COPYBSS 


001 110 


Short 

CopyValue (short valueOffset, 

byte[] dstBuf fer, short dstOff set , short dstLength) 


CPYVS_BSS 


001111 


Byte 

F i ndAndCompa r e Va lue (byte tag,byte[] c ompar eBu ffer, sho 
rt compareOf f set ) 


FAGRB_BS 


010000 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuffer, short compareO 
ffset, short compareLength) 


FACRBBS_BSS 


010001 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuf fer, short dstOff set, 
short dstLength) 


FACYBBS_BSS 


010010 


Short 

f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


FAGYB_BS 


010011 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010100 


Short 

GetLength 


GLEN 


010101 


Byte 

GetValueByte (short valueOffset) 


GVBYS 


010110 


Short 
GetValueLength 


GVLE 


010111 
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A.2.8 ProactiveResponseHandler methods 









short CopyAdditionalInf ormation (byte [ ] dstBuffer, 
short dstOffset, short dstLength) 




UUUUU 1 


Short copyTextString (byte [ ] dstBuffer, short 
dstOffset) 


CPTS_BS 


000010 


Short getAdditionalInf ormationLength ( ) 


GTIL 


000011 


Byte getGeneralResult ( ) 


GTGR 


000100 


Byte getltemldentif ier ( ) 


GTII 


000101 


Byte getTextStringCodingScheme ( ) 


GTCS 


000110 


Short getTextStringLength ( ) 


GTTL 


000111 


GetTheHandler 


GTHD 


001000 








Inherited Method Name: ViewHandler 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, s 
hort compareOf f set , short compareLength) 


GPRVS_BSS 


001001 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLength 
) 


OUr Yboo 


UU1 U1 u 


Short 

CopyValue ( short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


OrYVo boo 


UU1 Ul \ 


By t e 

FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


rML/riD Do 


UU 1 1 uu 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOf f s et , by t e [ ] compareBuf fer, short compareO 
f f set, short compareLength) 


FAGRBBS_BSS 


001101 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


PMO I DDo DOO 


uu IIIU 


Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FACYB BS 


001 1 1 1 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010000 


Short 

GetLength 


GLEN 


010001 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010010 


Short 
GetValueLength 


GVLE 


010011 
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l\/lath/^rl Moma 
ivlclllUU l^cllllt; 


A f* m n \twYt c 
MOl Uil yi llo 


Ml itTiharin/i f\w\ (\ hitc 
l>IUII lUcI II Uil D Ullo 


AllocateTimer () 


rt 1 IIVI 


WWV 1 


chan(^sMsnuEnt r"y (byts id^ byts [ ] msnuEntiry , shoirt 


L/Mb 1 D_DObDZDO 


UUUU1 U 


offsst^ shoirt lsn(^th, byts nsxtAction, boolsan 






hslpSuppoirt sd, byts iconQualif isir, short 






i con I dent i f ier ) 






clearEvent (byte event) 


CEVTB 


000011 


disableMenuEntry (byte id) 


DMETB 


000100 


enableMenuEntry (byte id) 


EMETB 


000101 


getEnt ry ( ) 


GETY 


0001 in 

\J\J\J 1 1 \J 






UUU 1 1 1 


initMenuEntry (byte [ ] menuEntry, short offset, short 


IMET_BSSBZBS 


001000 


length, byte nextAction, boolean helpSupported, byte 






IconQualif ier , short Iconldentif ier ) 






isEventSet (byte event) 


lEVSB 


001001 


releaseTlmer (byte timerldentif ier ) 


RTIM 


001010 


requestPollInterval (short duration) 


RPOL 


001011 


setEvent (byte event) 


SEVTB 


001100 


setEventLlst (byte [ ] eventLlst, short offset, short 


SEVL BSS 


001101 


length) 







A.2.10 ViewHandler methods 

The numbering of the ViewHandler methods it will be done in the classes inherit it: EditHandler, EnvelopeHandler, 
ProactiveResponseHandler, ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2.11 ToolkitException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit ( short reason) 


THUS 


000001 


ToolkitException (short reason) 


COORS 


000010 


Constants 


CONS 


00001 1 



ETSI 



3GPP TS 11 .13 version 7.4.1 Release 1998 369 ETSI TS 101 955 V7.4.1 (2002-03) 

Annex B (normative): 

Script file syntax and format description 

B. 1 Syntax description 

Following is a syntax description in BNF. 

<statement list> ::= [ <statement> \n] + 

<statement> ::= <simple> I <switch> I <blank line> 

<simple> ::= <reset> I <init> I <command> I <remark> 

<reset> ::= RST 

<init> ::= INI <hexdata> 

<conmiand> ::= CMD <hexdata> [ <response> ] ( <status> ) 

<response> ::= [ <hexdata> ] 

<status> ::= ( <hexdata> ) 

<remark> ::= REM <text lino 

<switch>::= SWI { [<labelled list>] + } 

<labelledlist> ::= <label> : \n <statement list> 

Description of syntax metalanguage : 

\n represents a linebreak 

[ X ] means x can appear optionally 

[ X J + means 1 or more appearances of x 

X I y means x or y 

[ ] { } : (bold) these are characters that appear literally in the script files 

<text lino any character until the end of the hne 
<blank lino a line containing no text is acceptable 

<hexdata> data written in hexadecimal, each byte separated from the following by a whitespace 

Each simple statement beginning with 3 characters different than the ones defined indicates another tool command, and 
shall be ignored by the parser if not recognised. 

' ' , ' \ t ' : Can be used as separator 

A long statement can be broken into several hues by using the character '\' at the end of each line which is not the last 
one in the statement. 

For more details refer to the examples in B.3. 

B.2 Semantics 

Following is the meaning of each of the statements : 
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CMD : Sends an APDU Command to the card, including (optionally) the expected response data and also (optionally) 

the expected status words SWl, SW2. 
RST : Resets and powers on the card 

INI : Performs the terminal profile with the following data. Afterwards, it shall perform all the fetch and terminal 

response commands until there is no proactive session in progress. 
REM : Used for comments 

swi : Activates a switch condition. Every labelled hst represents a Ust of statements to be executed, if the label 
matches the SW resulting from the previously executed conmiand. 



Evaluation of expected response and status in the case of a CMD: 

<response> data within [. . .] has to be checked, it needs to be present for an outgoing command. Bytes written as XX 

shall not be checked by the APDU tool. 
<status> status contained within (...) has to be checked; when several status are valid they shall be separated by 

cormnas. Bytes written as XX shall not be checked by the APDU tool. 



B.3 Example 

REM this is an example 
RST 

INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
REM Case 1 example 

CMD AO C2 00 00 00 (91 33 , 69 XX) 

REM Case 2 example 
CMD AO B6 00 00 07 \ 

[XX XX XX 55 55 XX 55] \ 

(91 33 , 67 XX) 



CMD AO B6 00 00 07 \ 
(91 33 , 67 XX) 

CMD AO CO 00 00 IF \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \ 
02 OD CC CC CC CC CC CC CC CC CC CC CC CC CC ] \ 
(90 00) 

REM Case 3 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 
08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 
02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 
00 00 00 \ 
(90 00) 

REM Case 4 example with switch statement 
CMD 00 A4 04 00 10 \ 

AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 02 \ 
(61 XX, 6A 82) 

SWI { 
61 XX: 

CMD 00 CO 00 00 14 \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 \ 
02 02 CC CC] \ 
(90 00) 

CMD AO A4 00 00 02 \ 
3F 00 

6A 82: 
RST 

} 
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B.4 Style and formatting 

In order to show a common appearance all the scripts shall follow those format rules: 

- start always with a 'RST' followed by an 'INI' command. 

- The command, data to be checked and status to be checked shall be presented in the following order: 
CMD COMMAND [EXPECTED DATA] (EXPECTED STATUS) 

- APDU shall be presented with command (CLA INS PI P2 P3) in one line and data (if present) in next line 
grouped 16 bytes per line (see example above). 

- The expected data (if present) shall be presented in 16 bytes groups per line (see example above). 
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Annex C (normative): 
Default Prepersonalisation 



C.1 General Default Prepersonalisation 

This table shows the defauh prepersonalisation, the file system and the files' content, that the test SIM cards shall 

contain unless otherwise stated. 



Name 


Identifier 


Default Value 


Snecial Features 


triCCiD 




OF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF 




This value is not compliant with GSM 11.11 


EFiMSi 


6F07 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF 




This value is not compliant with GSM 11.11 


EFlp 


6F05 


01 


FF 


FF 


FF 














EFkc 


6F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 07 






EPpi MNcpl 
■ — ■ n i_ivii Nstii 


6F30 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EPUDI KJIM 


6F31 


05 




EFACMmax 


Dno/ 


00 


00 


00 














Arrocc mnrlitinn 1 IPHATF' 

MLrLrCoo LrUI lUIUUI 1 U F L/M 1 C. on V 1 


EFssT 


o roo 


FF 


3F 


C3 


03 


OC 


00 


FF 


OF 00 33 






tl-ACM 


broy 


00 00 00 


Access COnulIIOn UrUA 1 1. L>nVl 


EFpucT 


6F41 


FF 


FF 


FF 


00 


00 










Access condition UPDATE: CHV1 


EFbcch 


6F74 


FF 
FF 


FF 
FF 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFacc 


6F78 


00 


00 


















EFfplmn 


6F7B 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFloci 


6F7E 


FF 


FF 


FF 


FF 


00 


FO 


00 


00 00 FF 01 






CrAD 


RFAD 


00 


FF 


FF 
















EFphase 


6FAE 


03 




EFfdn 


6F3B 


Default value 


in all 


the records 




Records: 5 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsMSP 


6F42 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 










EFlnd 


6F44 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsMSS 


6F43 


FF 


FF 


















EFsMS 


6F3C 


2 St 


record : 


00 


FF 


.. FF (length 176) 


Records: 3 








record: 00 FF ... 


FF {length 176) 










3rd 


re 


cor 


d: 


00 


FF 


.. FF (length 17 6 






EFadn 


6F3A 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFccp 


6F3D 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 




EFmsisdn 


6F40 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsDN 


6F49 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 


FF 








FF 


FF 


FF 


FF 














EFsUME 


6F54 


85 
53 


OC 
54 


54 
FF 


4F 
FF 


4F 
FF 


4C 
FF 


4B 


49 54 20 54 


45 




EFcBMI 


6F45 


FF 


FF 


















EFiM 


4F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF FF FF FF 







The default value for the CHVl shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state shall be 'disabled' 
during test applets execution. 
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C.2 Sim.Access.SimView test default prepersonalisation 
C.2.1 DFsiMTEST (SIM Test) 

Identifier: '0319' 



C.2.2 EFtnr (Transparent Never Read) 





Identifier: '6F01' 


1 Structure: transparent 


Mandatory 


File size: 3 bytes 


Update activity: low 






Access Conditions: 








READ 


NEVER 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Description 


Default Value 


M/O 


Length 


1 -3 


Test Data 


AA AA AA 


M 


3 bytes 



C.2.3 EFjNu (Transparent Never Update) 





Identifier: '6F02' 


1 Structure: transparent 


Mandatory 


File size: 3 bytes 


Update activity: low 






Access Conditions: 








READ 




ALWAYS 








UPDATE 


NEVER 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Description 


Default Value 


M/O 


Length 


1 -3 


Test Data 


55 55 55 


M 


3 bytes 



C.2.4 EFtaru (Transparent Always Read and Update) 





Identifier: '6F03' 


1 Structure: transparent 


Mandatory 


File size: 260 bytes 


Update activity: low 






Access Conditions: 








READ 




ALWAYS 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Bytes 


Descnption 


Default Value 


M/O 


Length 


1 -260 


Test Data 




FF ... FF 


M 


260 












bytes 
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Identifier: '6F04' 




Structure: cyclic 




Mandatory 


Record lengtli: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




NEVER 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.6 EFcNu (Cyclic Never Update) 



Identifier: '6F05' 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




NEVER 






INCREASE 




NEVER 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


GO 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.7 EFcNic (Cyclic Never Increase) 



Identifier: '6F06 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




NEVER 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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Identifier: '6F07 




Structure: cyclic 




Mandatory 


Record lengtli: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




NEVER 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.9 EFcNRH (Cyclic Never Rehabilitate) 



Identifier: '6F08' 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


NEVER 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


GO 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.10 EFcARu (Cyclic Always Read and Update) 



Identifier: '6F09' | 




Structure: cyclic 




Mandatory 


Record length: 3 bytes 


Update activity: high 




Access Conditions: 








READ 




ALWAYS 






UPDATE 




ALWAYS 






INCREASE 




ALWAYS 






INVALIDATE 




ALWAYS 






REHABILITATE 


ALWAYS 




Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AAAAAA 


M 


3 bytes 
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C.2.1 1 EFlnr (Linear Fixed Never Read) 





Identifier: '6F0A' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 










READ 




NEVER 










UPDATE 




ALWAYS 










INVALIDATE 




ALWAYS 










REHABILITATE 


ALWAYS 








Logical 


Description 




Default Value 




M/0 


Lengtfi 


Record 














Number 














1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 2 EFlnu (Linear Fixed Never Update) 





Identifier: '6F0B' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 










READ 




ALWAYS 










UPDATE 




NEVER 










INVALIDATE 




ALWAYS 










REHABILITATE 


ALWAYS 








Logical 


Description 




Default Value 




M/0 


Length 


Record 














Number 














1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 3 EFlaru (Linear Fixed Always Read and Update) 





Identifier: '6F0C' 


Structure: linear fixed | 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INVALIDATE 




ALWAYS 








REHABILITATE 


ALWAYS 






Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AAAAAAAA 


M 


4 bytes 
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C.2.14EFciNA (Cyclic Increase Not Allowed) 



Identifier: '6F0D' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: high 



Access Conditions: 





READ 
UPDATE 
INCREASE 

INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 
ALWAYS (see note1) 
ALWAYS 
ALWAYS 






Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



Note 1 : This file will be personalised in a way such that increase is not allowed, as indicated by the 
FCI byte 8, bit 7 (GSM 1 1 .11 : FCI structure of an EF returned by the SELECT command) 



C.2.15EFtrac (Transparent Read Access Condition CHV2) 



Identifier: '6F0E' 




Structure: transparent | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 






CHV2 








UPDATE 




ALWAYS 








INCREASE 




ALWAYS 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 






Default Value 


M/0 


Length 


Number 














1 


Test Data 


00 00 00 


M 


3 bytes 



C.2.16EFtiac (Transparent Invalidate Access Condition CHV1) 



Identifier: '6F0F' 


Structure: transparent 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 










READ 






ALWAYS 










UPDATE 




ALWAYS 










INCREASE 




ALWAYS 










INVALIDATE 




CHV1 










REHABILITATE 




ALWAYS 








Logical Record 


Description 






Default Value 




M/0 


Length 


Number 
















1 


Test Data 


00 00 00 


M 


3 bytes 
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C.2.17EFciAc (Cyclic Increase Access Condition CHV2) 



Identifier: '6F10' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: low 



Access Conditions: 

READ ALWAYS 

UPDATE ALWAYS 

INCREASE CHV2 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 





Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.18EFciAA (Cyclic Increase Access Condition ADM) 



Identifier: '6F11' 




Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INCREASE 




ADM 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 




Default Value 


M/0 


Length 


Number 












1 


Test Data 


GO 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.19EFcNRi (Cyclic Never Rehabilitate Invalidated) 



identifier: '6F12' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 


Update activity: low 



Access Conditions: 

READ ALWAYS 

UPDATE ALWAYS 

INCREASE ALWAYS 

INVALIDATE ALWAYS 

REHABILITATE NEVER 





Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



The file status shall be invalidated as defined in [3] 
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Annex D (normative): 

sim.test.util package and loading , testing and cleaning 
script examples. 

See attached files: 

- Annex_D_SimTestUtil.zip 

- Annex_D_Examples.zip 
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Annex E (normative): 
Test Area files. 

See attached file: 

- Annex_E_SourceCode.zip 
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Annex F (Normative): 

AID numbering and acronyms for Framework tests 



F.1 Toolkit Installation Parameters (TIN) 



Test Area within tlie cliapter 


Acronyms 


Numbering on 6 bits 


Timer allocation 


TMAL 


000001 


Item identifier 


ITID 


000010 


Item position 


ITPO 


000011 


Access conditions 


ACCO 


010 


Priority level 


PRLV 


000101 


IVIaximum length for each menu entry 


MLME 


000110 


Number of menu entries 


NBME 


000111 


Memory space 


MESP 


001000 



F.2 Minimum Handler Availability (MHA) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


EnvelopeResponseHandler 


ERHD 


000100 
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F.3 Handler Integrity (HIN) 



Test Area within tlie cliapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


RFU (EnvelopeResponseHandler) 


(ERHD) 


000100 



F.4 Applet Triggering (APT) 



Test Area wittiin the chapter 


Acronyms 


Numbering on 6 bits 


EVENT PROFILE DOWNLOAD 


EPDW 


000001 


EVENT MENU SELECTION 


EMSE 


000010 


EVENT MENU SELECTION HELP REQUEST 


EMSH 


000011 


EVENT FORMATTED SMS PP ENV 


EFSE 


000100 


EVENT UNFORMATTED SMS PP ENV 


FUSE 


000101 


EVENT CALL CONTROL BY SIM 


ECCN 


000110 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000111 


EVENT TIMER EXPIRATION 


ETEX 


001000 


EVENT UNFORMATTED SMS CB 


EUCB 


001001 


EVENT EVENT DOWNLOAD MT CALL 


EDMC 


001010 


EVENT EVENT DOWNLOAD CALL CONNECTED 


EDCC 


001011 


EVENT EVENT DOWNLOAD CALL DISCONNECTED 


EDCD 


001100 


EVENT EVENT DOWNLOAD LOCATION STATUS 


EDLS 


001101 


EVENT EVENT DOWNLOAD USER ACTIVITY 


EDUA 


001110 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


EDIS 


001111 


EVENT EVENT DOWNLOAD CARD READER STATUS 


EDCR 


010000 


RFU (EVENT UNRECOGNIZED ENVELOPE) 


(EUEN) 


010001 


EVENT STATUS COMMAND 


ESTC 


010010 



F.5 Proactive Command Sending (PCS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


System Proactive commands 


SPCO 


000001 


Interaction with GSM commands 


IGCO 


000010 


Errors during proactive command sending 


EPCS 


000011 



F.6 Envelope Response Posting (ERP) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT CALL CONTROL BY SIM 


ECCN 


000001 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000010 


EVENT UNRECOGNIZED ENVELOPE 


EUEN 


000011 



F.7 Framework Security (FWS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Input data 


INDA 


000001 


Output data 


OUDA 


000010 
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F.8 File System Context (FSC) 



Test Area within t>ie ciiapter 


Acronyms 


Numbering on 6 bits 


Initial Context 


INIT 


000001 


Context Preservation for Current File 


CUFI 


000010 


Context Preservation for Current Record 


CURE 


000011 



F.9 Exception Handling (EXH) 



Test Area witliin tlie ciiapter 


Acronyms 


Numbering on 6 bits 


Hide exception to the mobile 


HEME 


000001 


Interaction with multi-triggering 


IMTG 


000010 



F.1 Other parts transferred to framework from API (API) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


A handler is a temporary JCRE Entry Point object 


HEPO 


000001 


Transaction 


TRAN 


000010 


Timer Id between Applets 


TMID 


000011 
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Annex G (Normative): Configuration Parameters File 

This file describes all the mandatory and optional parameters that are used in order to create the loading script(s) for one 
test area. The configuration parameters file contains the values for the parameters needed in order to generate the 
loading and cleanup scripts. 

The name of the parameters file will be <test area reference>_<n>.par. 

The number <n> is associated with the loading/cleanup script number, i.e. API_2_TKR_ SEVL_BSS_l.par is used to 
generate API_2_TKR_ SEVL_BSS_l.ldr etc. 



G.1 Syntax 

The general syntax for this file will be: 

<file> ::= <section>+ 

<section> ::= <section heading> <line break> <section body> 
<section heading> : := ' [ ' <name> ' 
<section body> ::= <parameter assignment>+ 

<parameter assignment> ::= <name> = ' <value> <line break> 
Where '+' indicates one or more repetitions of the previous syntax element. 

Any text included between the symbol ' ; ' and the end of Une is considered a comment and ignored by parsing tools. 

Empty values are considered valid. They are used to indicate that an optional value is not present. 

Names of sections, names of parameters and values are case-sensitive. 

Blank spaces and Tabs between tokens are allowed and will be ignored by the parser. 

When values represent a sequence of bytes, they are expressed in hexadecimal format, where every 2 digits represent 
one byte. Blank space between bytes is optional. 



Example: 



; comment 




[Sectionl ] 




Parameterll 


= 00 11 22 33 


Parameterl2 


=0101 ; another comment 


[Section2] 




Parameter21 


= vvwwxxyyzz 



G.2 File Contents and Organisation 

Parameters in this file are organised in the following sections: 
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[CONVERT] 


Conversion parameters used during conversion (i.e. CAP file generation) 


[INSTALL{load)] 


Parameters used by the Install for Load command 


[LOAD] 


Parameters used by the Load command 


[INSTALL(install)] 


Parameters used by the Install for Install command 



All sections may appear only once in the file, except for the "INSTALL(install)" section. If that section appears more 
than once, it will apply to different applet instances, in sequence. 

G.2.1 Default values, order and processing 

The ordering of the parameters and the sections is relevant, since parameter names may be repeated and apply to 
different applets. 

When one single parameter is repeated within one section, it refers to different applets. The value of the n'* appearance 
of the parameter appUes to applet n. 

When one section is repeated (INSTALL(install)), then the n"' appearance of the section applies to applet n. 
Parameter/value pairs which are found in one appearance of the section are valid for the subsequent applets as long as 
they are not overriden. For example, first INSTALL(install) may contain all values for parameters, whereas the 
subsequent INSTALL(install) sections may only contain parameters whose values change. 

If one required parameter is missing from one section, the last defined value of this parameter in a previous section of 
the same file will be used. 

G.2.2 CONVERT Section 



These parameters allow configuration of the conversion process of the Java class file(s) into one CAP file. 



Parameter 


Description 


PackageAID 


AID of the package 


PackageName 


Fully qualified name of the package 


PackageVersion 


Version of the package 


AppletClassAID 


AID of the applet 


AppletClassName 


Name of the applet 



G.2.3 INSTALL(load) Section 

Here are the parameters to be included in the Install (Load) command (as specified in GSM 03.48 [8] ). 



Parameter 


Description 


PackageAID 


AID of the package 


PackageNonVolatileMemSize 


Non Volatile memory space (in bytes) required for package loading 


InstallatlonNonVolatileMemSIze 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 



G.2.4 LOAD Section 

Here are the parameters to be included in the Load command (as specified in GSM 03.48 [8] ). 



Parameter 


Description 


MaxLoadCommandDataLength 


Maximum length of the data provided in the load command (P3 
parameter of the LOAD APDU embedded in the command packet) 



G.2.5 INSTALL(install) Section 

Here are the parameters to be included in the Install (Install) command (as specified in GSM 03.48 [8] 
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Parameter 


Description 


PackageAID 


AID of the package 


A M M 1 Imam a I P\ 

AppletClassAID 


AID of the applet 


Instance AID 


AID of the Instance of the applet 


InstallationNonVolatileMemSize 


Non volatile memory required for Installation, In bytes 


InstallationVolatlleMemSize 


Volatile memory required for installation, in bytes 


AccessDomain 


Specify the SIIVI files that may be accessed by the applet and the 
operations allowed on these files. This parameter includes the 
rtccess uomain rarameier [t\ur) ano Mccess uomain uaia ^muu^ 


PrIorltyLevel 


Priority level of the Toolkit applet Instance 


MaxNumberOfTimers 


Maximum number of timers allowed for this applet Instance 


MaxMenuEntryTextLength 


Maximum text length for a menu entry 


MaxNumberOf Menu Entries 


Maximum number of menu entries allowed for this applet instance 


MenuEntriesPositionldentlfler 


For each menu entry: Position and Identifier of that menu entry 


AppletSpecificParameters 


Parameters specific to the applet 



The applet shall be installed with install(install and make selectable) command. 



G.3 Full example 



[CONVERT] 












PackageAID = AO 00 00 00 30 00 02 FF FF FF FF S 


39 00 


00 


01 


00 




PackageName = sim. test . access . api_l_svw_updrbs 












PackageVersion = 1.0 












AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


3 00 


00 


01 


01 


AppletClassName = API_1_SVW_UPDRBS_1 












AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


3 00 


00 


01 


02 


AppletClassName = API_1_SVW_UPDRBS_2 












[INSTALL (load) ] 












PackageNonVolatileMemSize = 0D27 












; InstallationNonVolatileMemSize = 0400 












; InstallationVolatlleMemSize = 0000 












[ LOAD ] 












MaxLoadCommandDataLength = 6C ; max value 












[INSTALL (install) ] 












AppletClassAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


3 00 


00 


01 


01 


InstanceAID = AO 00 00 00 30 00 02 FF FF FF 


FF 8 


3 00 


00 


01 


01 


InstallationNonVolatileMemSize = 0400 












InstallationVolatlleMemSize = 0000 












AccessDomain = 00 












PriorityLevel = FF 












MaxNumberOfTimers = 00 












MaxMenuEntryTextLength = 10 
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MaxNumberOfMenuEntries = 01 










MenuEntriesPositionldentif ier = 0001 










AppletSpecif icParameters = 










[INSTALL (install) ] 










AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 8 


9 00 


00 


01 


02 


InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 8 


9 00 


00 


01 


02 


InstallationNonVolatileMemSize = 0200 










InstallationVolatileMemSize = 0000 










MenuEntriesPositionldentif ier = 0002 











; rest of INSTALL (install) parameters are taken from previous INSTALL (install) ... 
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Annex H (informative): 
Change history 



The table below indicates all changes that have been made to the present document since drafting work began. 



Change history 


Date 


TSG# 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Did 


New 


2000-10 












Draft presented at T3 #1 6 




0.2.0 


2000-12 


TP-10 


TP-000208 








Presented to TSG-T #10 for information 


0.2.0 


1.0.0 


2001-01 












Input to T3 #17 resulting from T3 ad hioc #24 


1.0.0 


1.1.0 


2001-03 












Document presented for approval at T3 #18 


1.1.0 


1.2.0 


2001-03 


TP-11 


TP-010041 








Doument presented for approval to TSG-T #1 1 (identical 
in technical content to v1 .2.0) 


1.2.0 


2.0.0 


2001-03 












As approved at TSG-T #1 1 (identical in technical content 
to V2.0.0) 


2.0.0 


7.0.0 


2001-05 












Correction to date on cover page / headers 


7.0.0 


7.0.1 


2001-06 


TP-12 


TP-010105 


A001 




F 


Corrections to the API Test plan, addition of the test area 
files and modification of the util package 


7.0.1 


7.1.0 


2001-09 


TP-13 


TP-0 10206 


A002 




F 


Update API Test plan and Test Area Files 


7.1.0 


7.2.0 


2001-11 


TP-14 


TP-010241 


A003 




F 


Specification for framework part 


7.2.0 


7.3.0 


TP-010241 


A004 




F 


API part 


2002-03 


TP-15 


TP-020073 


004 




F 


Testing Framework Update 


7.3.0 


7.4.0 


2002-03 












Files for Annexes D and E added, Editorial correction 
performed in 6.3.2.3.3 colomn 9 (1- Applet triggered) 


7.4.0 


7.4.1 
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V7.3.0 


December 2001 
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